geocoding

--- name: geocoding description: 把中文地址/地标/道路名通过本地地理编码 API 解析成经纬度，并生成可点击打开高德地图的连接。当用户给出一个地点名称要定位、求坐标、或在地图上标记某处时使用。 description_zh: 地理编码 + 高德地图跳转链接 --- # Geocoding Skill 把**中文地址 / 地标 / 道路名**解析成**经纬度**，并生成一个**可点击打开高德地图**的连接。 数据源：天地图 POI + OpenStreetMap/Nominatim + Overpass + 本地路网，多源融合，中文地址识别好。 ## 何时使用 用户说出一个地点名称，需要：定位到某处、拿到坐标、或"在高德地图上看看"。 ## API 信息 - 服务地址：`http://public.dupetrc.qiyi.us:31882/api_geocoding` - 单地址：`GET/POST /api/geocode` - 批量：`POST /api/batch_geocode` ### 参数 | 参数 | 可选值 | 默认 | 说明 | |------|--------|------|------| | `query` | 字符串 | 必需 | 地址 / POI / 道路名 | | `output_type` | `ORIGINAL` / `REGION` | `REGION` | `ORIGINAL`=原始点线面要素；`REGION`=多边形缓冲面（默认，更快更精简） | | `source` | `MULTI`/`TIANDITU`/`OSM`/`LOCAL`/`OVERPASS` | `MULTI` | 数据来源 | | `skip_city_check` | `true`/`false` | `true` | 是否跳过自动补城市前缀 | | `allow_read_cache` | `true`/`false` | `true` | 命中缓存优先返回 | | `allow_save_cache` | `true`/`false` | `true` | 成功结果写入本地 SQLite 缓存 | ### 返回结构 单地址返回一个 JSON 对象，关键字段： - `raw.lat` / `raw.lon` —— **纬度 / 经度**（用于地图定位，核心字段） - `name` —— 解析出的名称（如 "东方明珠电视塔"） - `raw.display_name` —— 完整地址 - `raw.category` / `raw.addresstype` —— 类型（building/road...） - `source` —— 命中的数据源（nominatim / tianditu / local 等） - `geometry` —— GeoJSON 几何（`output_type=ORIGINAL` 时为多边形顶点数组，很大，解析时忽略） 批量返回 `{ "results": [ 单个地址同样结构 ... ], "total": N }`。 ## 用法 **直接调用 helper 脚本**（推荐，已封装好取坐标和高德链接）： ```bash # 单地址 python3 skills/geocoding/geocode.py "东方明珠" # 指定数据源 / 输出类型 python3 skills/geocoding/geocode.py "南京玄武湖" --source OSM --output-type ORIGINAL # 批量（每行一个地址，从 stdin） printf '世纪公园\n外滩\n田子坊\n' | python3 skills/geocoding/geocode.py --batch ``` 脚本输出 JSON，含 `name` / `lat` / `lon` / `link` / `google_maps` / `source`。其中 `link` 是高德地图（移动端调 App）、`google_maps` 是谷歌地图。 ## 输出格式（重要） 拿到的地图链接**一律用 Markdown 超链接形式**发给用户，不要发裸 URL： - Telegram / Markdown 渠道：`🗺️ 高德地图：[点击打开](<link>)`、`🗺️ 谷歌地图：[点击打开](<google_maps>)` - 默认**同时给出高德 + 谷歌**两个可点链接（除非用户只要其中一个） - 若某渠道不支持 Markdown 链接，再退化为发裸 URL ## 高德地图跳转链接 使用高德开放平台 **URI API（marker）**，官方文档： https://lbs.amap.com/api/uri-api/gettingstarted 格式（注意经度在前、逗号后是纬度）： ``` https://uri.amap.com/marker?position=lon,lat&callnative=1&name=名称 ``` - `position=lon,lat` —— 坐标（逗号分隔，默认 gaode/gcj02 坐标系） - `callnative=1` —— **移动端调起高德 App 查看**（关键，否则只在网页） - `name` —— 标注点名称（可选） 若坐标是 wgs84（GPS 原始坐标），再追加 `coordinate=wgs84`。 ## 输出示例 ``` 名称：东方明珠电视塔 坐标：31.2419464, 121.4952604 高德地图：https://uri.amap.com/marker?position=121.4952604%2C31.2419464&callnative=1&name=东方明珠电视塔 谷歌地图：https://www.google.com/maps/?q=东方明珠电视塔%2031.2419464%2C121.4952604 ``` ## 备注 - 取坐标只读 `raw.lat` / `raw.lon`，不要解析 `geometry` 的多边形数组（很占体积）。 - 默认 `output_type=REGION` 就够；需要精确边界（地块/园区轮廓）时才用 `ORIGINAL`。 - 失败时返回非 200 或无 `raw.lat`，此时告知用户未找到，不要编造坐标。 ## 两个地图链接 - **`link`**（高德）：`https://uri.amap.com/marker?position=lon,lat&callnative=1&name=…` - 移动端能调起高德 App（`callnative=1` 是关键） - **`google_maps`**（谷歌）：`https://www.google.com/maps/?q=lat,lon` - 谷歌地图用 `lat,lon` 顺序（与高德相反），移动端点开后尝试调起谷歌地图 App ## 收到照片时：从照片定位 如果用户发来**照片**，按下面流程走： 1. **拍 EXIF**：用 `exiftool -GPSLatitude -GPSLongitude -GPSAltitude -DateTimeOriginal <照片路径>` 读坐标。若 exiftool 没装，先用 `python3 -c "from PIL import Image; Image.open(path).getexif()"` 试读。若没有坐标字段，就告诉用户这张图没带位置信息（常见于聊天软件转发/压缩过的图）。 2. **把坐标喂给 geocode.py**：`exiftool -s3 -GPSLatitude -GPSLongitude 图` 通常直接吐经度/纬度两个数，可直接传给脚本；或反过来用 `geocode.py` 的接口做二次确认。 - 注意 EXIF 经度是东/西经、纬度是南/北纬：东经 N 正、西经 N 取负；北纬 N 正、南纬 N 取负。`exiftool -GPSLatitude/Longitude` 默认带 `E/N` 后缀，脚本只认数字，需先去掉方向后缀并按规则取符号。 3. 拿到结果后，按上面的「输出格式」要求，给用户**中文地址 + 高德/谷歌两个可点链接**。 ⚠️ 坐标精度取决于相机 GPS：手机/相机拍的定位准，截图/转发的图往往没有或不准。

存档时间线

版本索引永久保留；内容副本只保留最新 1 份，更早版本仅留索引与哈希（存档时间线的证据链不会因此断裂）。

下载存档内容副本

相关资产