Appearance
功能说明
用户在移动端添加收货地址或选择就近自提门店时,系统通过调用腾讯位置服务(Tencent LBS)接口实现地图选点、地址逆地址解析(经纬度转省市区详细文本)与定位搜索。
详细配置步骤
在腾讯位置服务申请 Key
- 访问 腾讯位置服务控制台 并登录。
- 进入【应用管理】 -> 【我的应用】 -> 点击【创建应用】。
- 在应用下点击【添加 Key】:
- Key 名称:例如“承信租商城定位”。
- 启用产品:勾选 【WebService API】(非常关键!必须开启 WebService API)。
- 安全设置:
- 若为后端反代请求模式,选择“IP 白名单”填入服务器公网 IP,或留空白名单以便多端调用。
- 若在前端 H5/小程序直接调用,需在“授权 APPID / 域名白名单”中配置商城域名与小程序 AppID。
在 EBAOZU 后台配置地图 Key
- 登录平台总后台 -> 进入【设置】 -> 【系统设置】 -> 【基础设置 / 地图配置】。
- 填入在腾讯位置服务申请的 腾讯地图 Key。
- 保存并重启 Swoole 守护进程。
接口测试与联调排查
在浏览器中直接调用逆地址解析接口测试 Key 是否有效:
text
https://你的域名/api/geoLbscoder?location=34.32908,108.70641- 正常返回:返回包含省、市、区、具体街道及周边 POI 信息的 JSON 数据。
- 报错排查:若返回
status: 311 (key 不存在)或status: 110 (请求来源未被授权),请核对腾讯位置服务控制台中的 WebService API 勾选状态与白名单规则。