tmap-lbs-skills

SKILL.md 节选

# 腾讯地图位置服务 Skill

腾讯地图位置服务向开发者提供完整的地图数据服务，包括地点搜索、路径规划、旅游规划等功能。

## 功能特性

- 🔍 POI（地点）搜索功能
- 🏙️ 支持关键词搜索、城市限定、类型筛选
- 📍 支持周边搜索（基于坐标和半径）
- 🛣️ 路径规划（步行、驾车、骑行、公交）
- 🗺️ 智能旅游规划助手
- 📈 轨迹数据可视化展示
- 💾 配置本地持久化存储
- 🎯 自动管理腾讯地图 Web Service Key

## 首次配置

首次使用时需要配置腾讯地图 Web Service Key：

1. 访问 [腾讯位置服务](https://lbs.qq.com/dev/console/key/add) 创建应用并获取 Key
2. 设置环境变量：`export TMAP_WEBSERVICE_KEY=your_key`
3. 或运行时自动提示输入并保存到本地配置文件

当用户想要搜索地址、地点、周边信息（如美食、酒店、景点等）、规划路线时，使用此 skill。

## 触发条件

用户表达了以下意图之一：

- 搜索某类地点或某个确定地点（如"搜美食"、"找酒店"、"天安门在哪"）
- 基于某个位置搜索周边（如"西直门周边美食"、"北京南站附近酒店"）
- 规划路线（如"从天安门到故宫怎么走"、"规划驾车路线"）
- 旅游规划（如"帮我规划北京一日游"、"杭州西湖游览路线"）
- 包含"搜"、"找"、"查"、"附近"、"周边"、"路线"、"规划"等关键词
- 轨迹可视化（如"帮我生成轨迹图"、"上传轨迹数据"、"GPS 轨迹展示"）
- 设置或提供 API Key（如"我的 key 是 xxx"、"设置 key"、用户直接粘贴了一串 key 字符串）

## 场景判断

收到用户请求后，先判断属于哪个场景：

- **场景一**：用户搜索一个**明确的类别**（美食、酒店）或**确定的地点**（天安门、西湖），没有指定"在哪个位置附近"
- **场景二**：用户搜索**某个位置周边或者附近**的某类地点，输入中同时包含「位置」和「搜索类别或者 POI 类型」两个要素（如"西直门周边美食"、"北京南站附近酒店", "搜索亚洲金融大厦附近的奶茶店"）
- **场景三**：POI 详细搜索（使用 Web 服务 API）
- **场景四**：路径规划
- **场景五**：智能旅游规划
- **场景六**：设置 Web Service Key（用户提供了 API Key）
- **场景七**：轨迹可视化（用户提供了轨迹数据地址，想生成轨迹图）

---

## 场景一：明确关键词搜索

直接搜索一个类别或地点，不涉及特定位置的周边搜索。

> 📖 详细的 URL 格式、执行步骤、示例和回复模板请参考 [references/scene1-keyword-search.md](references/scene1-keyword-search.md)

---

## 场景二：基于位置的周边或者附近搜索

用户想搜索**某个位置周边或者附近**的某类地点。需要先通过地理编码 API 获取该位置的经纬度，再拼接带坐标的搜索链接。

**前置条件：** 需要用户提供腾讯位置服务的 API Key。

> 📖 匹配到此场景后，**必须先读取** `references/scene2-nearby-search.md` 获取详细的执行步骤、API 格式、完整示例和回复模板，严格按照文档中的步骤执行。

---

## 场景三：POI 详细搜索

使用腾讯地图 Web 服务 API 通过 shell curl 进行 POI 搜索，支持关键词搜索、城市限定、周边搜索等。

> 📖 详细的 curl 请求格式、参数说明和返回数据格式请参考 [references/scene3-poi-search.md](references/scene3-poi-search.md)

---

## 场景四：路径规划

使用腾讯地图 Web 服务 API 通过 shell curl 规划路线。支持步行、驾车、骑行（自行车）、电动车、公交等多种出行方式。

> 📖 详细的 curl 请求格式、各出行方式的 API 端点、参数说明和返回数据格式请参考 [references/scene4-route-planning.md](references/scene4-route-planning.md)

---

## 场景五：智能旅游规划

SKILL.md 不止这些内容，安装后可阅读全文。

技能包内容

共 11 个文件，合计 46.0 KiB