🗺️ 地图指挥官

腾讯地图统一协作技能中心

🎯

核心定位

智能路由

本技能作为腾讯地图生态的 统一协作入口，根据用户需求自动选择合适的子技能协调工作。无论你需要地图可视化、地址处理、路径规划还是周边分析， 地图指挥官都能一键搞定！

⚡ 子技能体系 ⚡

🌐 tencentmap-jsapi-gl-skill

前端地图开发 Web端

专注于 Web端地图应用开发，提供丰富的交互和可视化能力

基础地图展示（2D/3D）
地图控件和交互
覆盖物：点标记、矢量图形
信息窗体和弹窗
点聚合和热力图
轨迹展示和动画
数据可视化（弧线图、散点图）
三维模型展示（GLTF/3DTiles）

需要 Key: TMAP_JSAPI_KEY

🔧 tencentmap-webservice-skill

后端数据接口 WebService API

提供 服务端数据接口，支持地理编码、POI搜索、路线规划等

地理编码（地址→坐标）
逆地理编码（坐标→地址）
POI搜索（关键词、周边）
关键词输入提示
路线规划（驾/步/骑/公交）
距离矩阵计算
天气查询 & IP定位
坐标系转换（GPS↔国测局）

需要 Key: TMAP_WEBSERVICE_KEY

🚀 tencentmap-lbs-skill

高级位置服务 LBS封装

高级位置服务封装，适合复杂业务场景

POI搜索增强
路径规划增强
旅游规划
周边搜索
轨迹数据处理
地图数据可视化

需要 Key: TMAP_WEBSERVICE_KEY

🎛️ 智能决策流程

👤 用户需求输入

描述你的地图相关需求

⬇️

🎯 需求分析

需要前端展示？ → tencentmap-jsapi-gl-skill
需要后端数据？ → tencentmap-webservice-skill
复杂LBS需求？ → tencentmap-lbs-skill

⬇️

⚙️ 子技能加载

按需加载对应子技能，验证Key配置

⬇️

🚀 执行任务

调用腾讯地图API，完成数据处理

⬇️

✨ 结果呈现

整合结果，以可视化方式呈现

🔑

Key 配置指南

子技能	需要的Key	说明
tencentmap-jsapi-gl-skill	`TMAP_JSAPI_KEY`	JS API专用Key
tencentmap-webservice-skill	`TMAP_WEBSERVICE_KEY`	WebService专用Key
tencentmap-lbs-skill	`TMAP_WEBSERVICE_KEY`	与WebService共用

🔐 签名配置（正式Key必需）

如果 Key 开启了签名校验（SN校验），需要额外配置 Secret Key：

                
# Windows CMD
setx TMAP_SECRET_KEY "你的SecretKey"

# PowerShell
[Environment]::SetEnvironmentVariable('TMAP_SECRET_KEY', '你的SecretKey', 'User')

# 环境变量完整配置
TMAP_JSAPI_KEY=你的JSAPI Key
TMAP_WEBSERVICE_KEY=你的WebService Key
TMAP_SECRET_KEY=你的Secret Key（如果开启了签名校验）
                
            

📌 正式环境请到腾讯位置服务控制台申请正式Key

💡 使用示例 💡

示例 1

用户：帮我做一个地图页面，显示全国各城市的销售数据

分析：需要前端展示 + 数据可视化

行动：加载 tencentmap-jsapi-gl-skill，使用热力图/散点图展示销售数据

示例 2

用户：把Excel里的地址批量转成坐标

分析：需要后端数据处理

行动：加载 tencentmap-webservice-skill，批量调用地理编码API

示例 3

用户：帮我规划从深圳到广州的自驾路线，显示途经景点

分析：需要路线规划 + POI搜索

行动：加载 tencentmap-webservice-skill 进行路线规划，
加载 tencentmap-jsapi-gl-skill 在地图上展示路线和景点标记

🎮 趣味技能 🎮

🗺️ 「地图指挥官」内置了 5 个有趣的技能，让地图不只是工具！

🍽️

美食雷达

美食雷达附近好吃的

分析周边美食分布，随机推荐宝藏小店

支持：中餐/火锅/烧烤/日料/西餐/甜品/咖啡

💑

约会神器

约会约会地点

智能找中间位置，推荐约会好去处

餐厅+咖啡厅+电影院组合推荐

🏃

跑步路线

跑步跑步路线

搜索附近公园绿道，生成跑步路线

折返跑/环形跑，用时卡路里估算

🏠

搬家参谋

搬家宜居指数

分析周边配套，计算综合宜居指数

超市/医院/学校/地铁全方位分析

🎲

随机探险

随机推荐有趣的地方，说走就走

每天不一样的惊喜半日游路线

📋

协作原则

单一职责
每个子技能做好自己的事，不越界
按需加载
只加载需要的子技能，避免资源浪费
Key统一管理
确认所需的Key已配置，签名校验通过
结果整合
多技能协作时，整合各技能结果统一呈现
容错备选
API失败时自动切换到联网搜索

🔄

备选机制：API失败自动切换

容错

当腾讯地图API调用失败时，自动切换到 联网搜索 作为备选方案，确保服务不中断。

🎯 触发条件

API返回错误码（status ≠ 0）
网络请求超时（> 5秒）
Key未配置或配置错误
API配额超限
跨域或CORS问题

🔍 搜索策略

地理编码失败 → 搜索「地名 + 地址 + 经纬度」
POI搜索失败 → 搜索「类型 + 城市 + 推荐」
路线规划失败 → 搜索「起点 → 终点路线」
天气查询失败 → 搜索「城市 + 天气预报」
其他失败 → 搜索用户原始需求关键词

⚠️ 注意事项

联网搜索结果可能不如API精确，仅作为备选。如果联网搜索也失败，告知用户并建议检查网络或Key配置。

📚