ThinkPHP6.x 地图服务：集成高德/百度地图实现位置标记与距离计算

当你在ThinkPHP6.x的项目里捣鼓位置标记和距离计算的时候，和地图服务打交道几乎是绕不开的一环。高德和百度这两家，都提供了成套的Web API和SDK，从地理编码、逆地理编码到路径规划和距离测算，一条龙服务。下面，咱们就来盘一盘，怎么把这两家的能力整合进你的项目里。

一、申请高德地图 API Key 并配置服务

想用高德的接口，第一步自然是去它的开放平台报到。注册账号、实名认证，这是标准流程。弄完之后，进控制台，在“应用管理”里创建一个新应用。名字随便起，类型记得选“Web端”。

在这个新应用里，把“Web服务API”的服务开关打开。高德会给你生成一个独一无二的 Key，记好它，这是之后所有请求的通行证。

最后一步，回到你的ThinkPHP项目，找到 config/app.php 这个配置文件，把你的Key塞进去，比如：'amap_key' => '您的高德Key'。这就齐活了。

二、封装高德地理编码与距离测算工具类

在一个项目里，你可能需要在多个地方把地址转成坐标，或者算两点之间的距离。每次都手写请求逻辑，既麻烦又容易出错。聪明的做法是封装一个服务类，一劳永逸。

具体操作上，在 app/common/service 目录下新建一个 AmapService.php 文件。在这个类里，你可以定义两个核心方法：

第一个是 getGeocode($address)，它负责把“北京市朝阳区”这样的地址，调高德的接口转成经纬度。请求的链接格式大概是这样：https://restapi.amap.com/v3/geocode/geo?address=xxx&key=xxx。

第二个是 getDistance($origin, $destination)，它用来算两个坐标点之间的直线或者驾车距离。这里的参数格式是有讲究的，得按照 经度,纬度 的格式来传。

发请求的时候，直接用ThinkPHP内置的 thinkHttp 工具发个GET请求就行。别忘了，拿到返回的JSON数据后，要做好异常判断，然后再把需要的字段提取出来。

三、申请百度地图 AK 并配置 HTTPS 白名单

百度这边的流程也类似，但它的安全校验方式有点不同。生产环境里，推荐用“AK + Referer白名单”的组合，这样更安全。

登录百度地图开放平台的控制台，创建一个应用。类型要选“浏览器端”，然后最关键的一步是设置 Referer 白名单。开发阶段你可以填 localhost 或 127.0.0.1，上线后就要换成你的正式域名了。如果不小心填错，接口会返回 AK INVALID 的错误，排查起来挺折腾。

设置完之后，拿到生成的 AK（Access Key），同样在ThinkPHP的 config/app.php 里加上 'baidu_ak' => '您的百度AK'。

四、实现百度地理逆编码与步行距离测算

高德的“地理编码”是把地址转成坐标，那“逆地理编码”就是反着来，把坐标转成结构化的地址信息。这个功能在需要知道“用户当前在哪个街道”的场景下特别有用。

在 app/common/service 下新建一个 BaiduService.php 类。在里面实现两个方法：

第一个是 reverseGeocode($lng, $lat)，请求百度的逆地理编码接口，把经纬度传进去，就能拿到详细的地址。

第二个是 getWalkingDistance($origin, $destination)，用来算步行距离。它调的是步行路线规划API。对于判断比如“这个门店是否在用户周边500米以内”的场景，这个接口非常合适。

解析返回的数据时，主要关注 result.route.distance 这个字段，单位是米，拿到后直接返回一个整型就行。

五、在控制器中调用双地图服务进行位置标记渲染

后端准备就绪，剩下的就是前端的事儿了。其实关键就两步：后端提供经纬度，前端把点标在地图上。

在控制器里，你可以实例化刚才写好的 AmapService 或 BaiduService，传入地址拿到经纬度。然后组装成一个包含 name、address、longitude、latitude 的数组，用 json_encode() 输出给前端。

在前端页面上，引入对应地图的JS API。比如用高德，就引入它的JS SDK。然后，通过AJAX拿到后端返回的坐标列表，在地图实例上循环调用 new AMap.Marker({position: [lng, lat]})，一个个标记点就打上去了。整个过程清晰流畅，没有复杂的弯弯绕绕。