地名地址
地名地址的标准流程是 确定查询口径 => 选技能 => 取坐标 => 入库或出图 成败的关键在“同一个地名,不同数据源给的坐标可能不是同一个点”同一个“黄鹤楼”,在线天地图、已入库的 PG 业务表、离线 1:25 万地名库可能给出相差几十公里的三个点。查询前先把口径说清楚,比事后修坐标省力得多。
三种查询场景怎么选
默认顺序建议: 没指定来源时先走离线库(免费、可批量、不联网);需要景点级精度再走天地图在线;需要属性字段或统计口径时走项目 PG 库。
场景一:在线查地名(tianditu-geocoder)
触发词:地名转坐标、地址转经纬度、位置纠偏、修正坐标、geocode。
实测输出(WGS84)
- 关键判据是
score和level。 只输入“黄鹤楼”时命中结果可能是level: 区县及以上级行政区划、score: 0,也就是匹配到了行政区划而非景点;补上城市名“武汉黄鹤楼”后才是兴趣点、score: 99。 - 失败判定: 只有
status === "0"且经纬度可解析为数字才算成功;返回失败时保留关键词并记下message,加城市、省份或景区全名重试。 - 限制: 依赖外网,且服务有访问频次限制,不适合几十万行的大批量地理编码;大批量请先落到离线库或项目库。
场景二:查 PG 库里已有的地名地址(postgis-cli)
涉及空间数据、查库、查表、查字段、要素数这类问题,先让postgis-cli 盘点,再写查询。
- 表名随项目库而定。 有的项目库把地标放在自建表(如历史地标、景点表),有的放在 OSM 全量 POI 表(
gis_osm_pois_free_1一类)。所以务必先db search/spatial search确认,不要凭经验写死表名。 - 只读用
query run/query explain/query geojson。 落表要用query write-table,且必须用户明确要求才写库。 - 库内也提供了地名地址检索函数,可直接 SQL 调用(与场景三同一份数据):
场景三:离线查 1:25 万地名地址(postgis-poi-address)
触发词:离线地名地址、POI 查询、地址转坐标、附近查点、search_poi、不联网做地理编码。
kind 类别取值(节选)
实测输出
- 结果固定是 EPSG:4326 的 GeoJSON FeatureCollection,坐标顺序为
[lon, lat]。 - 数据粒度局限: 这是 1:25 万宏观地名库,收录的是居民地、水系、地形、交通等宏观要素,不含景区内部微地名(如某个园、某条步道、某栋楼)。查不到就如实说明库里没有,不要改用在线 geocoder 或自己编造坐标。
- 连接串: 与
postgis-cli相同,优先POSTGISCLI_DATABASE_URL,其次DATABASE_URL。不要额外传--conn,也不要把连接串、主机地址写进文档或页面里。 - 预览页约定: 页面由脚本生成,不要再手写第二份 HTML;运行环境找不到 MapLibre 资源时会自动降级成 SVG 点位图,此时点位与名称仍然可见,不需要另外补一份页面。
三条路径的坐标差异
用同一个“黄鹤楼”实测:离线库的“黄鹤楼”是景点东南方向约 92 km 处的同名村庄居民点,两者不是一回事;真正靠近景点的是“黄鹤楼街道”(相距约 0.8 km)。拿到结果先看kind/level/score,再决定用哪一个点,不要默认第一条就是想要的。
常见问题
- 同名地点歧义: 关键词加城市或省份前缀;在线查询用
--compare判断偏移量,偏离目标超过可接受范围就换更具体的关键词。 - score 很低或为 0: 说明匹配精度差,通常是关键词太泛或地名有歧义,补全名重试。
- 只要坐标不要地图: 三个技能都能只输出 JSON / GeoJSON / CSV,去掉
--html、--out即可。 - 要落到前端显示: 统一用 EPSG:4326 经纬度,
[lon, lat]顺序;入库或出图可参考遥感影像的投影预处理一节。
使用提示: 在对话里直接说清“在线还是离线”“用哪个库”,例如“离线查询黄鹤楼的地名地址”“查询 PG 数据库黄鹤楼的地名地址”,可显著减少来回确认。