Overpass API 基于 [wiktorn/Overpass-API](https://github.com/wiktorn/Overpass-API) 的懒猫微服应用，提供 OpenStreetMap Overpass API 服务，支持初始数据加载和增量更新。 ## 功能特性 - 🗺️ **Overpass API 服务**：完整的 OSM 数据查询 API - 🌍 **Web 区域选择**：通过管理界面选择数据区域，随时切换 - 📥 **灵活的数据加载**：支持 HTTP/FTP/BitTorrent 下载初始数据 - 🔄 **增量更新**：自动从 OSM 差异源获取数据更新 - 📊 **Web 管理界面**：监控 API 状态、下载进度、存储使用 - ⚡ **aria2 下载引擎**：高性能多协议下载管理 - 🔧 **PBF 自动转换**：自动检测 PBF 格式并转换为 BZ2，支持转换进度显示 ## 架构 本应用由三个容器组成： | 容器 | 说明 | |------|------| | **overpass-api** | Overpass API 主服务（基于 wiktorn/overpass-api 镜像） | | **aria2** | 下载管理器，支持 HTTP/FTP/BT 协议 | | **manager** | Web 管理界面，监控和控制各服务 | ## 配置参数 | 参数 | 说明 | 默认值 | |------|------|--------| | `OVERPASS_META` | 元数据模式：`no`=无元数据(最小)、`yes`=含元数据、`attic`=含历史数据(最大) | `no` | | `OVERPASS_COMPRESSION` | 数据压缩方式：`gz`(平衡) 或 `lz4`(更快更大) | `gz` | | `OVERPASS_UPDATE_SLEEP` | 增量更新检查间隔（秒） | `3600` | | `OVERPASS_RULES_LOAD` | 区域生成强度 (1-100) | `10` | | `OVERPASS_RATE_LIMIT` | 单 IP 最大并发访问数 | `2` | | `ARIA2_RPC_SECRET` | aria2 RPC 密钥 | 随机生成 | | `ARIA2_ENABLE_IPV6` | 为下载器启用 IPv6 | `true` | ## 使用方法 ### 首次部署 1. 部署应用后，访问管理界面 2. 在 "Regions" 标签页中选择数据区域（如中国、欧洲等） 3. 系统将自动通过 aria2 下载区域数据 保存到网盘的osm目录下 4. 下载完成后，激活所选区域 Overpass API 将自动处理数据并启动服务 5. 可随时切换区域或添加自定义区域 ### API 查询 Overpass API 可通过以下地址访问（无需认证）： ``` https://overpass.<微服名>.heiyu.space./api/interpreter?data=<查询语句> ``` 在电网海报生成器中使用 请填写https://overpass.<微服名>.heiyu.space./api 示例查询： ``` [out:json]; node["amenity"="restaurant"](bbox); out body; ``` ### 管理界面 通过浏览器访问 `https://overpass.<你的域名>/` 进入管理界面，可查看： - **Dashboard**：服务状态总览（含预处理进度） - **Regions**：区域数据选择和管理（支持从目录选择或自定义 URL） - **Downloads**：下载任务管理（暂停/恢复/删除） - **Overpass API**：API 健康状态和日志（含预处理日志） ## 数据区域 在管理界面的 "Regions" 标签页中选择区域 支持自定义区域：提供 Geofabrik 或其他数据源的 URL 即可。 ### 代理配置 在添加下载任务或选择区域时，可以指定 HTTP 代理（如 `http://proxy:8080`），aria2 将通过代理下载数据。代理为可选项，不填则直连下载。适用场景： - 下载 Geofabrik 等国外数据源时网络受限 - 需要通过内网代理访问外部资源 ## 存储需求 - 数据库目录：根据区域不同，需要 5GB ~ 200GB 空间 - 下载目录：临时存储下载文件，需要与数据库相当的空间 ## 注意事项 - 首次数据加载可能需要数小时（取决于区域大小和网络速度） - 增量更新默认每小时执行一次，可通过 `OVERPASS_UPDATE_SLEEP` 调整 - `OVERPASS_RATE_LIMIT` 建议保持默认值 2，设为 0 会导致部分客户端（如 OSMnx）无法正常查询