| name | tencentmap-lbs-skill |
| description | 腾讯地图位置服务开发技能，支持POI搜索、路径规划、旅游规划、周边搜索，轨迹数据可视化和地图数据可视化。⚠️ 强制行为：本 Skill 加载后，第一个动作必须是检查是否存在正式 Key（环境变量 TMAP_WEBSERVICE_KEY 或用户已在对话中提供）。若已有正式 Key，直接继续处理用户请求。若没有正式 Key，必须立即向用户展示 Key 选择提示（正式 Key 注册引导 + 临时体验 Key 申请），然后停止等待用户选择，不得在用户选择之前进行任何分析、读取文件、规划方案或编写代码的操作。 |
| version | 1.0.2 |
| metadata | {"openclaw":{"requires":{"env":"TMAP_WEBSERVICE_KEY","bins":["tmap-lbs"]},"primaryEnv":"TMAP_WEBSERVICE_KEY","install":[{"id":"node","kind":"node","package":"@tencent-map/lbs-skills","bins":["tmap-lbs"],"label":"Install tmap-lbs (node)"}],"homepage":"https://lbs.qq.com/service/webService/webServiceGuide/webServiceOverview"}} |
腾讯地图位置服务开发技能
腾讯地图位置服务向开发者提供完整的地图数据服务，包括周边搜索，地点搜索、路径规划、旅游规划等功能。
Requirements
tmap-lbs
第一次使用如果没有安装 tmap-lbs，请先安装 tmap-lbs, 如果用户需要更新，也是同样的命令。
npm install @tencent-map/lbs-skills -g
前置检查：API Key
-
已有正式 Key（环境变量 TMAP_WEBSERVICE_KEY、tmap-lbs config get-key 或对话中提供）→ 直接使用
-
未检测到 Key 时向用户输出以下选项：
-
用户选择"申请临时 Key" → 读取 tempkey-guide.md 按其中步骤执行
功能特性
- 搜索
- 支持关键词和 POI 搜索功能
- 支持基于中心点坐标和半径周边搜索
- 规划
- 数据可视化
当用户想要搜索地址、地点、周边信息（如美食、酒店、景点等）、规划路线时，使用此 skill。
触发条件
用户表达了以下意图之一：
- 搜索某类地点或某个确定地点（比如"故宫在哪"，"搜酒店"、"找加油站"）
- 基于某个位置搜索周边（如"奥林匹克公园周边美食"、"北京西站附近的加油站"）
- 包含"搜"、"找"、"查"、"附近"、"周边"、"路线"、"规划"等关键词
- 旅游规划（如"帮我规划北京一日游"、"杭州西湖游览路线"）
- 规划路线（如"从故宫到南锣鼓巷怎么走"、"规划一条骑行路线"）
- 轨迹可视化（如"帮我生成轨迹图"、"上传轨迹数据"、"GPS 轨迹展示"）
场景判断
收到用户请求后，先判断属于哪个场景：
- 场景一：用户搜索某个位置周边或者附近的某类地点，输入中同时包含「位置」和「搜索类别或者 POI 类型」两个要素（如"西直门周边美食"、"北京南站附近酒店", "搜索亚洲金融大厦附近的奶茶店"）
- 场景二：POI 详细搜索（使用 Web 服务 API）
- 场景三：路径规划
- 场景四：旅游规划
- 场景五：轨迹可视化（用户提供了轨迹数据地址，想生成轨迹图）
场景一：基于位置的周边或者附近搜索
用户想搜索某个位置周边或者附近的某类地点。需要先通过地理编码 API 获取该位置的经纬度，再拼接带坐标的搜索链接。
📖 匹配到此场景后，必须先读取 references/scene1-nearby-search.md 获取详细的执行步骤、API 格式、完整示例和回复模板，严格按照文档中的步骤执行。
场景二：POI 详细搜索
使用腾讯地图 tmap-lbs 进行 POI 搜索，支持关键词搜索、城市限定、周边搜索等。
📖 详细的格式、参数说明和返回数据格式请参考 references/scene2-poi-search.md
场景三：路径规划
使用腾讯地图 tmap-lbs 规划路线。支持步行、驾车、骑行（自行车）、电动车、公交等多种出行方式。
📖 详细的格式、各出行方式的 API 端点、参数说明和返回数据格式请参考 references/scene3-route-planning.md
场景四：旅游规划
用户想去某个城市旅游，提供了多个想去的景点，需要规划最佳行程路线，并可选推荐餐厅、酒店等。需要先通过地理编码 API 获取各景点的经纬度，再拼接旅游规划链接。
📖 匹配到此场景后，必须先读取 references/scene4-travel-planner.md 获取详细的执行步骤、API 格式、完整示例和回复模板，严格按照文档中的步骤执行。
场景五：地图数据可视化
当用户有一份包含轨迹坐标的数据，希望在地图上以轨迹图的形式可视化展示。不需要 API Key。
触发条件
用户提到"轨迹"、"轨迹图"、"轨迹可视化"、"GPS 轨迹"、"运动轨迹"、"行驶轨迹"等意图，并提供了数据地址或轨迹数据。
📖 匹配到此场景后，必须先读取 references/scene5-trail-map.md 获取详细的 URL 格式、执行步骤、完整示例和回复模板，严格按照文档中的步骤执行。
注意事项
- 场景判断是关键：区分用户是"直接搜某个东西"、"在某个位置附近搜某个东西"、"规划路线"还是"旅游规划"
- 关键词应尽量精简准确，提取用户真正想搜的内容
- URL 中的中文关键词浏览器会自动处理编码，无需手动 encode
- 腾讯地图坐标格式为
纬度,经度（注意：纬度在前，经度在后）
- 如果 API 返回
status 不为 0，说明请求失败，需提示用户检查地址是否有效
- API Key 请妥善保管，切勿分享给他人
文档引用（references）
各场景的详细操作文档存放在 references/ 目录下：
相关链接
