ThinkPHP本身不提供地理位置接口，需自行对接第三方服务或数据库能力；关键在于超时控制、响应校验、地址清洗、缓存前置、坐标系识别及空间索引优化，而非仅调用API。
ThinkPHP 本身不处理地理位置接口，所有地址解析、坐标转换、距离计算都得靠你自己对接第三方服务或数据库能力。框架只提供 HTTP 请求、模型事件、查询构造等基础支撑，别指望它内置“一键定位”功能。
怎么调高德/百度地理编码接口不翻车
直接用 file_get_contents() 发请求最常见，但也是最容易出问题的：超时卡死、403 被限流、空响应写进数据库。关键不是“能不能发”，而是“怎么兜得住”。
- 必须设超时（
stream_context_create(['http' => ['timeout' => 5]])），别让整个页面等 30 秒 - 检查返回的
status字段：高德是status == 1，百度是status == 0，其他值一律跳过写入 - 地址要清洗：
trim(str_replace(["\n", "\r", "\t"], "", $address))，否则“北京市朝阳区 大悦城”这种带全角空格的会解析失败 - 缓存必须前置：查前先查
address_cache表，命中就跳过 API；没命中再调，成功后立刻写缓存（含expires_at） - 失败不抛异常，记日志 + 返回默认坐标（如城市中心点），避免表单提交中断
MySQL 里算距离为什么总不准或巨慢
用 Db::raw() 手写 Haversine 是最常踩的坑——单位没转弧度、参数顺序错、索引没建，结果要么是 0 米，要么查 10 万条数据要 8 秒。
- MySQL 5.7+ 必须用
ST_Distance_Sphere()，别自己算：ST_Distance_Sphere(POINT(?, ?), POINT(lng, lat)) -
lng和lat字段必须是DECIMAL(10,8)或DOUBLE，不能是VARCHAR - 表结构得加空间字段：
ADD COLUMN location POINT SRID 4326，再建SPATIAL INDEX，B-Tree 索引对地理范围无效 - WHERE 条件里不能用
AS distance别名，得重复写表达式，否则报错 - TP6 查询要写成
fieldRaw('*, ST_Distance_Sphere(POINT(?, ?), location) AS distance', [$lng, $lat])
为什么高德坐标和地图 SDK 显示位置对不上
不是代码错了，是国内坐标系强制偏移导致的。高德、腾讯返回的是 GCJ-02 坐标，而 GPS 设备、OpenStreetMap、PostGIS 默认用 WGS-84，两者偏差普遍在 50–500 米。
立即学习“PHP免费学习笔记（深入）”；
- 如果前端用高德 JS API 渲染，后端存高德坐标即可，无需纠偏
- 如果对接的是 GPS 终端或要做跨平台轨迹分析，必须调高德
/geoconv接口把 GCJ-02 转 WGS-84 - 百度坐标（BD-09）更麻烦，得先转 GCJ-02 再转 WGS-84，别图省事硬套公式，误差会放大
- TP 模型里存坐标前，建议加个字段标记来源：
coord_type enum('wgs84', 'gcj02', 'bd09')，后续逻辑好判断
真正难的从来不是调哪个函数，而是坐标系怎么选、缓存怎么设、失败怎么降级、索引怎么建——这些细节漏一个，上线后就是线上告警和用户投诉。
