首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >店铺点位漂移六百米?八成是坐标系在打架|数据鱼API

店铺点位漂移六百米?八成是坐标系在打架|数据鱼API

原创
作者头像
用户12862874
发布于 2026-11-18 22:34:38
发布于 2026-11-18 22:34:38
970
举报

又是那个点位漂移的工单。商家在后台把门店标在桥东,用户打开地图,红点稳稳落在桥西的河里。商家认定是我们定位算法不行,客服转来的截图我看了十分钟——经度 116.4,纬度 39.9,数字本身完美无缺。问题不在数字,在于从头到尾没人问过一句:这是哪个坐标系的数字。

下面拿数据鱼API的「地理坐标计算」服务当例子。坐标转换、测距、邻近点、围栏判断、geohash 编解码都在一个服务里,正好用它把漂移这事从头到尾捋一遍。

三套坐标一张图,谁也别说谁准

国内地图三套坐标系并存:国际标准的 WGS84,国内地图普遍用的 GCJ02——就是俗称的火星坐标,还有百度系的 BD09。海外数据源吐的是 WGS84,国内地图渲染默认 GCJ02,中间差几百米太正常了。三套坐标系没有谁对谁错,只有谁该用在哪个环节——错配才是漂移的主要来源。数据鱼这个接口的 convert 端点收 coords 坐标数组,一次最多 200 个点,from、to 指定 wgs84、gcj02、bd09,批量转完再渲染,红点当场归位。坐标数组是 [[lng,lat],...] 结构,门店、网点这类批量场景一次打包。各端点的取值上限不用背,调 stats 端点全在 limits 里写着,写死在前端不如每次取。

gcj02 转 wgs84 是逼近,不是翻译

反向转换没有解析解,数据鱼API用十轮迭代逼近,精度小于 0.1 米;文档的 accuracy_note 里还专门写了"境外点不做 GCJ 偏移",跨境业务别想当然。另一个我亲身踩过的坑:坐标是 [经度, 纬度],经度在前——参数说明里那句"如 [121.47, 31.23]"不是装饰,是给把顺序写反的人准备的,我就是那个人,靠报错信息里的示例才反应过来。反方向也通:给一串 geohash 或 maidenhead 编码,decode 返回中心点和边界框。网格聚合的常见做法就是 encode 到指定精度、按编码分组统计,分组键天生带地理含义。另外,转换结果落库时把坐标系标进字段名或版本备注里,gcj02 和 wgs84 各存各的列,下一个接手的人会感谢你。

顺手把几何账都算了

定位修好之后,剩下都是几何题。measure 用 haversine 算两点距离,地球半径按 6371000 米,带 16 方位角;destination 传方位角 0 到 360 加距离,算"往东南走五百米到哪";nearest 在最多 500 个候选点里挑最近的 k 个,k 上限 50;polygon 判断坐标是否落在围栏内,射线法,顶点上限 500、一次最多 200 个测试点。做网格聚合还有 geohash 与 maidenhead 的编解码,业余无线电报位置用的就是后者。这些能力拼起来就是一条轨迹链:destination 推算下一个点,measure 量两段距离,polygon 判进没进围栏——配送计价、跑腿范围这类业务,就是这么串出来的。nearest 的候选点支持带业务 ID 的写法([{id,lng,lat},...]),返回结果直接挂上门店号,不用再对表;polygon 要求至少 3 个顶点,配送范围、服务半径这类围栏,一次最多测 200 个点。

端点

上限

用途

convert

200 个坐标

三套坐标系互转

nearest

500 点、k≤50

最近邻查找

polygon

500 顶点、200 测试点

围栏内外判断

measure / destination

—

距离、方位与终点推算

代码语言:javascript
复制
POST /api/geo/convert
GET /api/geo/geohash/encode?lng=116.4&lat=39.9

工单最后写的是"坐标系混用,已批量转换"。那串漂移几百米的坐标从头到尾都是"对"的——错的从来不是数字,是没人声明数字活在哪个坐标系里。接地图功能的朋友,先把这句话贴在工位上:坐标不是数字,是坐标系里的数字。顺带一句,动手前先调免鉴权的 ping 确认服务在线,别让用户替你发现服务挂了。

以上端点、上限与精度说明,整理自数据鱼API「地理坐标计算」接口的公开文档;文中工单情节与坐标数值为演示用途的虚构数据。坐标转换结果建议与业务所用地图平台的官方口径交叉复核。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 三套坐标一张图,谁也别说谁准
  • gcj02 转 wgs84 是逼近,不是翻译
  • 顺手把几何账都算了
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档