OSM Overpass 查询工具

1. 什么是 Overpass API？

Overpass API 是 OpenStreetMap 的数据查询引擎，可以用类似 SQL 的 Overpass QL 语言，按位置、标签、类型等条件提取地图数据（道路、建筑、POI 等）。

2. 为什么需要 Worker 中转？

Overpass 官方实例在国内访问不稳定。本 Worker 部署在 Cloudflare 全球边缘网络，替你转发请求并处理跨域，你只需要访问这个页面即可。

3. 查询语法速览

• [out:json]; 指定输出 JSON
• node["amenity"="cafe"](bbox); 按标签和范围查询节点
• way["building"](area); 查询建筑物轮廓
• out body; 输出结果

4. 使用建议

• 查询范围尽量用 bbox 或 area 限定，避免全量扫描
• 在查询头中加入 [timeout:60]; 控制超时（秒）
• 复杂查询可先在 overpass turbo 调试

5. 结果字段说明

JSON 结果中 elements 数组包含节点(node)、路径(way)、关系(relation)。每个元素有 id、type、tags 等字段，路径和关系还包含 geometry 坐标。

6. 故障转移与超时

Worker 依次尝试多个 Overpass 实例，每个最多等待 60 秒，整体最多 130 秒。遇到 429 或 5xx 会自动切换到下一个实例，提高查询成功率。