腾讯地图小程序开发技能

帮助用户在微信小程序中实现地图功能开发，包含地图组件、位置服务、地图控制和后端服务能力。

目录结构

API 文档

所有API文档位于 references/ 目录：

地图组件文档

references/map_component_guide.md - 完整的小程序地图组件文档
- 地图基础属性：longitude、latitude、scale、rotate、skew等
- 标记点（marker）：在地图上显示标注，支持自定义图标、气泡、标签
- 路线（polyline）：绘制路线和彩虹线，支持箭头、文本标注
- 多边形（polygon）：绘制闭合区域，支持虚线边框
- 圆形（circle）：显示圆形覆盖物
- 点聚合：大量标记点的聚合展示
- 自定义气泡：callout、customCallout
- 地图事件：点击、视野变化、标记点点击等
- 碰撞检测：marker碰撞关系配置
- 地图控件：指南针、比例尺、3D楼块等

MapContext API文档

references/mapContext_api/ 目录包含32个API文档：

地图控制类

MapContext.md - MapContext总览
wx.createMapContext.md - 创建MapContext实例
MapContext.getCenterLocation.md - 获取地图中心点坐标
MapContext.moveToLocation.md - 移动到指定位置
MapContext.getRegion.md - 获取地图视野范围
MapContext.getScale.md - 获取地图缩放级别
MapContext.getRotate.md - 获取地图旋转角度
MapContext.getSkew.md - 获取地图倾斜角度
MapContext.setCenterOffset.md - 设置地图中心点偏移
MapContext.setBoundary.md - 限制地图显示范围
MapContext.includePoints.md - 缩放视野包含所有坐标点

标记点管理类

MapContext.addMarkers.md - 添加标记点
MapContext.removeMarkers.md - 移除标记点
MapContext.translateMarker.md - 平移标记点（带动画）
MapContext.moveAlong.md - 沿路径移动标记点（轨迹回放）
MapContext.setLocMarkerIcon.md - 设置定位点图标

点聚合类

MapContext.initMarkerCluster.md - 初始化点聚合配置
MapContext.addMarkers.md - 添加聚合标记点

覆盖物类

MapContext.addGroundOverlay.md - 添加自定义图片图层
MapContext.updateGroundOverlay.md - 更新自定义图片图层
MapContext.removeGroundOverlay.md - 移除自定义图片图层
MapContext.addArc.md - 添加弧线
MapContext.removeArc.md - 移除弧线

可视化图层类

MapContext.addVisualLayer.md - 添加可视化图层
MapContext.removeVisualLayer.md - 移除可视化图层
MapContext.executeVisualLayerCommand.md - 执行可视化图层指令

自定义图层类

MapContext.addCustomLayer.md - 添加个性化图层
MapContext.removeCustomLayer.md - 移除个性化图层

坐标转换类

MapContext.toScreenLocation.md - 经纬度转屏幕坐标
MapContext.fromScreenLocation.md - 屏幕坐标转经纬度

其他功能

MapContext.openMapApp.md - 拉起地图APP选择导航
MapContext.eraseLines.md - 擦除或置灰已添加的线段
MapContext.on.md - 监听地图事件

位置服务API文档

references/wx_location_api/ 目录包含12个API文档：

基础定位

wx.getLocation.md - 获取当前的地理位置、速度
wx.getFuzzyLocation.md - 获取模糊位置（隐私保护）

地图选点

wx.chooseLocation.md - 打开地图选择位置
wx.choosePoi.md - 选择POI点

位置展示

wx.openLocation.md - 使用内置地图查看位置

持续定位

wx.startLocationUpdate.md - 开启小程序前后台时均接收位置消息
wx.startLocationUpdateBackground.md - 开启小程序进入前后台时均接收位置消息
wx.stopLocationUpdate.md - 停止接收位置消息
wx.onLocationChange.md - 监听实时地理位置变化事件
wx.onLocationChangeError.md - 监听实时地理位置错误事件
wx.offLocationChange.md - 取消监听实时地理位置变化事件
wx.offLocationChangeError.md - 取消监听实时地理位置错误事件

LBS后端服务文档

references/lbs_service_guide/ 目录包含9个API文档：

SDK核心

qqMapwx.md - QQMapWX SDK核心类和使用指南

搜索服务

methodSearch.md - 地点搜索（周边POI搜索）
methodGetsuggestion.md - 关键词输入提示

地理编码

methodGeocoder.md - 地址解析（地址转坐标）
methodReverseGeocoder.md - 逆地址解析（坐标转地址）

路线规划

methodDirection.md - 路线规划（驾车、步行、骑行、公交）

距离计算

methodCalculatedistance.md - 距离计算（步行、驾车）

行政区划

methodGetcitylist.md - 获取全国城市列表
methodGetdistrictbycityid.md - 获取城市下行政区划

示例代码

assets/examples/ 目录包含3个完整的小程序示例项目：

minicode-location/ - 定位功能示例

完整的获取用户位置示例项目

minicode-marker/ - 标记点示例

完整的地图标记点示例项目

minicode-markerCluster/ - 点聚合示例

完整的点聚合功能示例项目

SDK库

assets/libs/ 目录：

qqmap-wx-jssdk.js - 腾讯位置服务微信小程序JS SDK
- 完整的SDK源码
- 支持地点搜索、路线规划、地理编码等功能

工作流程

1. 理解用户需求

当用户询问小程序地图相关问题时，首先明确：

功能类型：地图显示、定位、标记点、路线规划、搜索、地图控制等
平台：微信小程序
是否需要后端服务：判断是否需要调用腾讯位置服务API

2. 查询 API 文档

根据需求类型读取对应的 references 文件：

地图显示/组件相关 → 读取 references/map_component_guide.md
地图控制/MapContext → 读取 references/mapContext_api/ 下对应文件
定位和用户位置相关 → 读取 references/wx_location_api/ 下对应文件
LBS后端服务 → 读取 references/lbs_service_guide/ 下对应文件

对于大文件，使用 grep 搜索关键信息，例如marker：

grep -n "marker\|标记点" references/map_component_guide.md

3. 查找示例代码

根据需求在 assets/examples/ 目录查找对应示例：

定位功能 → assets/examples/minicode-location/
标记点功能 → assets/examples/minicode-marker/
点聚合功能 → assets/examples/minicode-markerCluster/

读取示例代码的关键文件：

# 查看页面结构
cat assets/examples/minicode-marker/index/index.wxml

# 查看页面逻辑
cat assets/examples/minicode-marker/index/index.js

4. 提供解决方案

根据文档和示例，为用户提供：

完整的代码示例（WXML + JS + WXSS）
API参数详细说明
注意事项和最佳实践
权限处理建议

注意事项

地图组件

坐标系：
- 小程序地图使用 GCJ-02（国测局坐标，火星坐标）
- wx.getLocation({ type: 'gcj02' }) 直接返回GCJ-02坐标
- GPS设备返回的WGS-84坐标需要转换
组件尺寸：
- <map> 标签建议设置宽高
个性化地图：
- 需要在微信公众平台购买并配置
- 使用 subkey 参数传入专属KEY
- 使用 layer-style 指定样式

权限声明：

自2022年7月14日后发布的小程序，使用位置接口需在 app.json 中声明

{
  "permission": {
    "scope.userLocation": {
      "desc": "你的位置信息将用于小程序位置接口的效果展示"
    }
  }
}

API规范（非常重要）：
- 所有API调用必须使用文档中定义的接口、属性、事件
- 所有参数必须严格遵守文档格式要求
- 不确定的参数格式请查阅对应demo

位置服务

调用频率限制：
- 基础库 2.17.0 起，wx.getLocation 增加调用频率限制
- 避免高频率调用，推荐使用持续定位接口
高精度定位：
- 开启高精度定位会增加接口耗时
- 可设置 highAccuracyExpireTime 控制超时时间
持续定位：
- 使用 wx.onLocationChange 进行持续定位
- 页面卸载时调用 wx.stopLocationUpdate 停止定位

腾讯位置服务 SDK

申请Key：
- 前往官网注册正式 Key：https://lbs.qq.com/dev/console/key/manage
- 或通过 tempkey 流程申请临时体验 Key（手机验证，14 天有效），用户同意后读取 tempkey-guide.md 按其中步骤执行
商业授权：
- 商业使用需要授权（政府公共事务及公益组织除外）
- 详见腾讯位置服务官网说明
错误处理：
- 注意处理返回的status和message
- 常见错误码：
  - 0: 正常
  - 310: 请求参数信息有误
  - 311: key格式错误
  - 110: 请求来源未被授权

性能优化

标记点优化：
- 标记点过多时使用点聚合功能
- 及时移除不需要的标记点
数据更新：
- 避免频繁 setData 更新地图数据
- 使用 setting 对象批量更新属性
路线优化：
- 路线点位过多时进行抽稀处理
- 使用 polyline 的 colorList 绘制彩虹线
内存管理：
- 及时移除不需要的图层和覆盖物
- 页面卸载时清理地图资源

详细的快速开始指南、常见场景和最佳实践，参见 references/quick_start_and_best_practices.md。

tencentmap-miniprogram-skill

安装到 Tokeny（自动）

SKILL.md