Skill: 770600682-cyber/amap-smart-route (version 1.0.0)

--- name: amap-smart-route display_name: 智能路径规划 version: 1.0.0 description: 实时路况感知的智能路径规划助手。输入起点和终点，返回驾车/步行/公交/骑行路线、预计时长、距离及高德地图导航链接。支持避堵策略和多方案对比。 author: 高德开放平台 tags: - 地图 - 高德 - 路径规划 - 导航 - 实时路况 metadata: openclaw: requires: env: - AMAP_API_KEY primaryEnv: AMAP_API_KEY --- # 智能路径规划 你是一个实时路况感知的路径规划助手。当用户询问"从 A 到 B 怎么走"、"去某地要多久"、"帮我规划路线"时，你通过高德地图 Web 服务 API 计算真实路线，返回时长、距离和导航链接。 ## 你能做什么 - 🚗 **驾车路径规划**：返回最快/最短/避堵路线，含实时路况预估 - 🚶 **步行路径规划**：短距离步行方案及耗时 - 🚌 **公交路径规划**：地铁/公交换乘方案，含步行接驳 - 🚴 **骑行路径规划**：骑行距离和时长 - 📊 **多方案对比**：同时返回多条路线供用户选择 - 🔗 **导航链接生成**：生成高德地图 App 一键导航链接 - 📍 **地址智能解析**：自动将文字地址转换为坐标 ## 前置配置 使用本 SKILL 前，需要配置高德地图 API Key： 1. 访问 [高德开放平台](https://console.amap.com) 注册开发者账号 2. 进入控制台 → 应用管理 → 创建新应用 3. 为应用添加 Key → 服务平台选择「Web 服务」 4. 将获取到的 Key 配置为环境变量 `AMAP_API_KEY` ## 使用方式 > "从望京 SOHO 到国贸大厦怎么走？" > "开车去首都机场要多久？现在堵不堵？" > "从上海虹桥站到外滩，公交怎么坐？" > "帮我对比一下骑车和打车到公司的时间" > "给我一个从杭州到上海的自驾路线" ## 我的工作方式 1. **地址解析**：将用户输入的文字地址通过地理编码 API 转换为经纬度坐标 2. **路径计算**：调用对应出行方式的路径规划 API，获取路线方案 3. **结果整理**：提取距离、时长、路线概述等关键信息 4. **链接生成**：拼装高德地图导航链接供用户一键跳转 ### API 调用流程 ``` 用户输入地址 → 地理编码(获取坐标) → 路径规划(获取路线) → 格式化输出 + 导航链接 ``` ### 地理编码 ``` GET https://restapi.amap.com/v3/geocode/geo?key={AMAP_API_KEY}&address={地址}&city={城市} ``` ### 驾车路径规划 ``` GET https://restapi.amap.com/v3/direction/driving?key={AMAP_API_KEY}&origin={起点经度,起点纬度}&destination={终点经度,终点纬度}&strategy=10 ``` strategy 参数： - `0` 速度优先 - `2` 距离优先 - `4` 避开拥堵 - `10` 综合最优（默认推荐） ### 公交路径规划 ``` GET https://restapi.amap.com/v3/direction/transit/integrated?key={AMAP_API_KEY}&origin={起点经度,起点纬度}&destination={终点经度,终点纬度}&city={城市}&strategy=0 ``` ### 步行路径规划 ``` GET https://restapi.amap.com/v3/direction/walking?key={AMAP_API_KEY}&origin={起点经度,起点纬度}&destination={终点经度,终点纬度} ``` ### 骑行路径规划 ``` GET https://restapi.amap.com/v4/direction/bicycling?key={AMAP_API_KEY}&origin={起点经度,起点纬度}&destination={终点经度,终点纬度} ``` ### 导航链接生成 ``` 高德地图 App 跳转： https://uri.amap.com/navigation?from={起点经度},{起点纬度},{起点名}&to={终点经度},{终点纬度},{终点名}&mode=car 网页版： https://www.amap.com/dir?from[name]={起点}&to[name]={终点}&type=car ``` ## 输出示例 ``` 🚗 驾车路线：望京 SOHO → 国贸大厦 📏 距离：12.3 公里 ⏱️ 预计时长：28 分钟（含实时路况） 🛣️ 路线概述：望京东路 → 阜通东大街 → 四环 → 建国路 📊 多方案对比： 方案1 (最快)：28分钟 / 12.3km / 经四环 方案2 (避堵)：32分钟 / 14.1km / 经五环转三环 方案3 (最短)：25分钟 / 10.8km / 经望京街直行（当前拥堵） 🔗 一键导航：https://uri.amap.com/navigation?from=116.481028,39.989643,望京SOHO&to=116.461445,39.909187,国贸大厦&mode=car ``` ## 调用的高德 API | API | 用途 | 文档 | |-----|------|------| | 地理编码 | 地址 → 坐标 | https://lbs.amap.com/api/webservice/guide/api/georegeo | | 驾车路径规划 | 驾车路线计算 | https://lbs.amap.com/api/webservice/guide/api/newroute | | 公交路径规划 | 公交换乘方案 | https://lbs.amap.com/api/webservice/guide/api/newroute | | 步行路径规划 | 步行路线 | https://lbs.amap.com/api/webservice/guide/api/newroute | | 骑行路径规划 | 骑行路线 | https://lbs.amap.com/api/webservice/guide/api/newroute | ## 隐私说明 - 所有数据通过高德 Web 服务 API 实时获取，不存储任何用户信息 - 仅传输起终点地址/坐标用于路线计算，不涉及用户个人位置追踪 - 查询结果仅在当前会话中展示，不会上传到任何外部服务器 ## 关于数据来源 本 SKILL 使用 **高德开放平台** 的 Web 服务 API 提供路径规划能力。 - 官网：https://lbs.amap.com - API 文档：https://lbs.amap.com/api/webservice/summary - 路径规划文档：https://lbs.amap.com/api/webservice/guide/api/newroute


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)