ThinkPHP 接入高德地图 API 实现地理编码与逆地理编码，前端用 JS SDK 选点展示，后端用 PHP 调用 Web 服务 API 完成地址与坐标双向转换，关键在于参数构造、GCJ-02 坐标系理解、响应解析及异常处理。
ThinkPHP 接入高德地图 API 实现地理编码（地址→坐标）和逆地理编码（坐标→地址），核心是前后端分工明确：前端用 JS SDK 选点、展示地图；后端用 PHP 发起 HTTP 请求调用高德 Web 服务 API，完成结构化地址与经纬度的双向转换。关键不在框架本身，而在参数构造、坐标系理解、响应解析和异常处理。
前端地图初始化与点击取点
在 ThinkPHP 模板中引入高德 JS API，并绑定地图容器：
- 确保页面加载时引入官方 SDK：
<script src="https://webapi.amap.com/maps?v=2.0&key=你的WebKey"></script> - 地图容器需有固定宽高（如
style="height:500px;"），ID 与 JS 初始化一致（如id="g-map"） - 点击地图获取经纬度后，分别填入隐藏或可见的输入框，注意顺序是「经度,纬度」，例如：
$("input[name='longitude']").val(e.lnglat.getLng());$("input[name='latitude']").val(e.lnglat.getLat()); - 建议添加 Marker 实时标记点击位置，并支持重复点击清除旧点，避免误操作
后端调用地理编码（地址转坐标）
适用于用户填写地址后自动补全经纬度，比如录入门店、社区时。
Map RTOS SDK - 高德官方嵌入式地图 SDK Skill
下载
Map RTOS SDK - 高德地图嵌入式 Map SDK 接入助手，支持栅格/矢量 Map 地图渲染、覆盖物绘制、轨迹导航及适配器实现指南
- 构造请求 URL：
https://restapi.amap.com/v3/geocode/geo?address=北京市朝阳区观湖国际1座&city=北京&key=你的WebKey - 使用
file_get_contents或cURL发送 GET 请求（推荐 cURL，可控性更强） - 解析 JSON 响应，检查
status === "1"和count > 0，再取geocodes[0].location（格式为"116.500748,39.941108"） - 注意：高德对「结构化地址」要求较严，省市区尽量完整；若只传“天安门”，也能识别，但稳定性不如带行政区划的地址
后端调用逆地理编码（坐标转地址）
适用于 GPS 设备上传坐标后，反查所属街道、区域、周边 POI 等信息。
立即学习“PHP免费学习笔记（深入）”；
- 请求地址示例：
https://restapi.amap.com/v3/geocode/regeo?location=116.500748,39.941108&radius=1000&extensions=all&key=你的WebKey -
location参数必须是「经度,纬度」字符串，逗号不能空格，顺序不可颠倒 -
extensions=all可返回更丰富的 AOI、POI、道路等信息；radius控制搜索半径（单位米） - 成功响应中，
regeocode.formatted_address是标准地址，regeocode.addressComponent包含省市区层级拆解，适合存库或二次加工
注意事项与避坑点
实际开发中容易忽略但影响稳定性的细节：
- API Key 必须申请「Web 服务型」，不是「JS API」Key —— 后者仅限浏览器端调用，服务端调用会返回
invalid key - 高德默认坐标系为 GCJ-02（火星坐标），若你原始数据来自 GPS 设备（WGS-84），需加
coordsys=gps参数让高德自动纠偏，否则地址偏移明显 - ThinkPHP 中建议封装成独立服务类（如
AmapService），把请求、重试、日志、缓存逻辑集中管理，避免控制器臃肿 - 生产环境务必做失败降级：比如逆地理编码失败时，至少保留原始坐标；地理编码失败时，允许手动填写经纬度作为兜底
