腾讯地图小程序开发

解决的问题

微信小程序地图开发常卡在组件属性、MapContext 行为、定位权限、腾讯位置服务 Key 和可视化图层配置之间。资料分散时，容易把 marker、polyline、点聚合、坐标转换、后端搜索写成猜测代码，或漏掉 subkey、layerId、APPID 授权等前置条件。

技能如何工作

该技能面向微信小程序，提供地图组件、MapContext、位置服务和 LBS 后端服务的 API 参考。它按需求类型读取 references/ 下的文档，并查找 assets/examples/ 中的 minicode-location、minicode-marker、minicode-markerCluster 示例。

• 地图能力：覆盖 longitude、latitude、scale、rotate、skew、marker、polyline、polygon、circle、点聚合、自定义气泡、碰撞检测和地图控件。
• 地图控制：覆盖 wx.createMapContext、移动视野、获取视野、限制范围、包含坐标点、标记点动画、轨迹回放、覆盖物、自定义图层和经纬度/屏幕坐标转换。
• 位置服务：覆盖 wx.getLocation、模糊定位、选点、POI、内置地图查看、前后台持续定位与错误监听。
• LBS 后端：覆盖地点搜索、输入提示、地理编码、逆地理编码、路线规划、距离计算和行政区划。

关键步骤是先判断功能类型，再决定是否调用腾讯位置服务 API；涉及后端 Key 时按用户提供、已保存 Key、临时 Key 的顺序处理；涉及可视化图层时必须询问真实 layerId，并确认 subkey 绑定与小程序 APPID 授权。

适用边界

适合微信小程序中的地图显示、定位、标记点、路线、搜索和地图控制。坐标系使用 GCJ-02，WGS-84 需转换；位置接口需声明权限，wx.getLocation 有频率限制；商业使用需关注授权。