5分钟上手Bottle.py+PostGIS：零门槛搭建轻量级地理信息服务

5分钟上手Bottle.py+PostGIS：零门槛搭建轻量级地理信息服务

【免费下载链接】bottle bottle.py is a fast and simple micro-framework for python web-applications. 项目地址: https://gitcode.com/gh_mirrors/bo/bottle

你还在为搭建地理信息服务烦恼？复杂框架配置、沉重依赖链、冗长开发流程是否让你望而却步？本文将用5分钟带你从零开始，用Bottle.py+PostGIS打造轻量级GIS服务，无需专业背景，小白也能快速上手！读完你将获得：

• 3步完成Bottle.py环境部署
• 5行代码实现空间数据API
• 零基础处理地理信息查询
• 生产级服务部署最佳实践

一、环境准备：3分钟极速配置

1.1 安装Bottle.py框架

通过GitCode镜像仓库获取项目源码，支持Windows/macOS/Linux全平台：

git clone https://gitcode.com/gh_mirrors/bo/bottle
cd bottle
pip install .  # 或使用虚拟环境隔离依赖

官方安装指南：docs/tutorial.rst

1.2 配置PostGIS数据库

PostGIS作为PostgreSQL的空间扩展，提供地理数据存储与查询能力：

# Ubuntu示例
sudo apt-get install postgresql postgis
# 创建空间数据库
sudo -u postgres psql -c "CREATE DATABASE gisdb;"
sudo -u postgres psql -d gisdb -c "CREATE EXTENSION postgis;"

1.3 项目结构设计

bottle-gis/
├── app.py          # 主应用入口
├── config.py       # 数据库配置
├── static/         # 静态资源 [docs/tutorial.rst#serving-assets](https://link.gitcode.com/i/8fb72b7a110b8f861f9c7deaf0281b1a)
└── views/          # 模板文件 [test/views/](https://link.gitcode.com/i/3bbaf62320b74ee789fae5753501d56f)

二、核心开发：5行代码实现GIS服务

2.1 初始化Bottle应用

创建app.py文件，导入核心模块并配置数据库连接：

from bottle import Bottle, response, json_dumps
import psycopg2  # PostgreSQL客户端
from psycopg2.extras import RealDictCursor

app = Bottle()  # 应用对象 [docs/tutorial.rst#the-application-object](https://link.gitcode.com/i/81ef3b325d1ffc8daefbb137982c5268)
db = psycopg2.connect("dbname=gisdb user=postgres")  # 数据库连接

2.2 实现空间查询接口

添加动态路由，支持经纬度范围查询：

@app.route('/points/<min_lng>/<min_lat>/<max_lng>/<max_lat>')  # 动态路由 [docs/tutorial.rst#dynamic-routes](https://link.gitcode.com/i/f1e81b101cfa074eee9a5bd9c6b3f9ef)
def get_points(min_lng, min_lat, max_lng, max_lat):
    with db.cursor(cursor_factory=RealDictCursor) as cur:
        cur.execute("""
            SELECT id, ST_AsGeoJSON(geom)::json as geometry 
            FROM points 
            WHERE geom && ST_MakeEnvelope(%s,%s,%s,%s,4326)
        """, (min_lng, min_lat, max_lng, max_lat))
        response.content_type = 'application/json'
        return json_dumps(cur.fetchall())

2.3 启动开发服务器

添加调试模式支持，自动重载代码变更：

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=8080, debug=True, reloader=True)  # 开发服务器 [docs/tutorial.rst#debug-mode](https://link.gitcode.com/i/dcf2344c63b16eca64085a6e8ea0e5c8)

三、功能测试：从浏览器到API调用

3.1 基础测试

启动服务后访问：

http://localhost:8080/points/116.3/39.9/116.5/40.1  # 北京区域查询示例

返回GeoJSON格式结果，可直接在QGIS等GIS软件中可视化。

3.2 错误处理

添加404页面自定义：

@app.error(404)  # 错误处理 [docs/tutorial.rst#error-handling](https://link.gitcode.com/i/36494896fc82ed963173ec5f120679a8)
def error404(error):
    return {'error': '数据范围无效', 'code': 404}

四、部署上线：生产环境最佳实践

4.1 使用Gunicorn作为WSGI服务器

pip install gunicorn
gunicorn -w 4 -b 0.0.0.0:8000 app:app  # 4进程并发 [docs/deployment.rst](https://link.gitcode.com/i/7e82d5e21d00875f5b39b3b7d08e078a)

4.2 配置Nginx反向代理

server {
    listen 80;
    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
    }
    location /static {  # 静态资源处理 [docs/tutorial.rst#serving-assets](https://link.gitcode.com/i/8fb72b7a110b8f861f9c7deaf0281b1a)
        alias /path/to/bottle-gis/static;
    }
}

五、进阶方向

5.1 安全增强

• 添加请求验证 test/test_auth.py
• 使用签名Cookie docs/tutorial.rst#signed-cookies

response.set_cookie("user", "admin", secret='your-secret-key')

5.2 性能优化

• 数据库连接池配置
• 结果缓存实现 plugins/

收藏本文，关注后续《Bottle.py+Leaflet实现WebGIS可视化》教程，点赞支持更多轻量级开发指南！

附录：关键文件索引

• 框架核心：bottle.py
• 测试用例：test/test_route.py
• 官方文档：docs/index.rst
• 路由教程：docs/routing.rst

【免费下载链接】bottle bottle.py is a fast and simple micro-framework for python web-applications. 项目地址: https://gitcode.com/gh_mirrors/bo/bottle