Skip to content
Back to search

amap-lbs-skill

SkillWorks with Claude CodeGitHub

高德地图综合服务,支持POI搜索、路径规划、旅游规划、周边搜索和热力图数据可视化

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/amap-web--amap-lbs-skill/badge.svg)](/listings/amap-web--amap-lbs-skill)

HTML

<a href="/listings/amap-web--amap-lbs-skill"><img src="/api/listings/amap-web--amap-lbs-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 475 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: amap-lbs-skill
  3. description: 高德地图综合服务,支持POI搜索、路径规划、旅游规划、周边搜索和热力图数据可视化
  4. version: 2.0.0
  5. metadata:
  6. openclaw:
  7. requires:
  8. env:
  9. - AMAP_WEBSERVICE_KEY
  10. bins:
  11. - node
  12. primaryEnv: AMAP_WEBSERVICE_KEY
  13. homepage: https://lbs.amap.com/api/webservice/summary
  14. install:
  15. - kind: node
  16. package: axios
  17. bins: []
  18. ---
  19. # 高德地图综合服务 Skill
  20. 高德地图综合服务向开发者提供完整的地图数据服务,包括地点搜索、路径规划、旅游规划和数据可视化等功能。
  21. ## 功能特性
  22. - 🔍 POI(地点)搜索功能
  23. - 🏙️ 支持关键词搜索、城市限定、类型筛选
  24. - 📍 支持周边搜索(基于坐标和半径)
  25. - 🛣️ 路径规划(步行、驾车、骑行、公交)
  26. - 🗺️ 智能旅游规划助手
  27. - 🔥 热力图数据可视化
  28. - 🔗 地图可视化链接生成
  29. - 💾 配置本地持久化存储
  30. - 🎯 自动管理高德 Web Service Key
  31. ## 首次配置
  32. 首次使用时需要配置高德 Web Service Key:
  33. 1. 访问 [高德开放平台](https://lbs.amap.com/api/webservice/create-project-and-key) 创建应用并获取 Key
  34. 2. 设置环境变量:`export AMAP_WEBSERVICE_KEY=your_key`
  35. 3. 或运行时自动提示输入并保存到本地配置文件
  36. 当用户想要搜索地址、地点、周边信息(如美食、酒店、景点等)、规划路线或可视化数据时,使用此 skill。
  37. ## 触发条件
  38. 用户表达了以下意图之一:
  39. - 搜索某类地点或某个确定地点(如"搜美食"、"找酒店"、"天安门在哪")
  40. - 基于某个位置搜索周边(如"西直门周边美食"、"北京南站附近酒店")
  41. - 规划路线(如"从天安门到故宫怎么走"、"规划驾车路线")
  42. - 旅游规划(如"帮我规划北京一日游"、"杭州西湖游览路线")
  43. - 包含"搜"、"找"、"查"、"附近"、"周边"、"路线"、"规划"等关键词
  44. - 希望将地理数据可视化为热力图(如"生成热力图"、"用这份数据做热力图展示")
  45. ## 场景判断
  46. 收到用户请求后,先判断属于哪个场景:
  47. - **场景一**:用户搜索一个**明确的类别**(美食、酒店)或**确定的地点**(天安门、西湖),没有指定"在哪个位置附近"
  48. - **场景二**:用户搜索**某个位置周边**的某类地点,输入中同时包含「位置」和「搜索类别」两个要素(如"西直门周边美食"、"北京南站附近酒店")
  49. - **场景三**:热力图数据可视化
  50. - **场景四**:POI 详细搜索(使用 Web 服务 API)
  51. - **场景五**:路径规划
  52. - **场景六**:智能旅游规划
  53. ---
  54. ## 场景一:明确关键词搜索
  55. 直接搜索一个类别或地点,不涉及特定位置的周边搜索。
  56. **URL 格式:**
  57. ```
  58. https://www.amap.com/search?query={关键词}
  59. ```
  60. - **域名**:`www.amap.com`
  61. - **路由**:`/search`
  62. - **参数**:`query` = 搜索关键词
  63. ### 执行步骤
  64. 1. **发送埋点统计请求**:在执行操作前,发送以下请求进行埋点统计:
  65. ```bash
  66. curl -s "https://restapi.amap.com/v3/log/init?eventId=skill.call&product=skill_openclaw&platform=JS&label=keyword-search&value=call"
  67. 2. **提取关键词**:从用户输入中识别出核心搜索词,去掉"搜"、"找"等修饰词
  68. 3. **生成 URL**:拼接 `https://www.amap.com/search?query={关键词}`
  69. 4. **返回链接给用户**
  70. ### 示例
  71. | 用户输入 | 提取关键词 | 生成 URL |
  72. |---------|-----------|---------|
  73. | 搜美食 | 美食 | `https://www.amap.com/search?query=美食` |
  74. | 找酒店 | 酒店 | `https://www.amap.com/search?query=酒店` |
  75. | 天安门在哪 | 天安门 | `https://www.amap.com/search?query=天安门` |
  76. | 找个加油站 | 加油站 | `https://www.amap.com/search?query=加油站` |
  77. ### 回复模板
  78. ```
  79. 🔍 已为你生成高德地图搜索链接:
  80. https://www.amap.com/search?query={关键词}
  81. 点击链接即可查看搜索结果。
  82. ```
  83. ---
  84. ## 场景二:基于位置的周边搜索
  85. 用户想搜索**某个位置周边**的某类地点。需要先通过地理编码 API 获取该位置的经纬度,再拼接带坐标的搜索链接。
  86. **前置条件:** 需要用户提供高德开放平台的 API Key。
  87. ### 执行步骤
  88. #### 第零步:发送埋点统计请求
  89. 在执行任何操作前,先发送以下请求进行埋点统计:
  90. ```bash
  91. curl -s "https://restapi.amap.com/v3/log/init?eventId=skill.call&product=skill_openclaw&platform=JS&label=nearby-search&value=call"
  92. #### 第一步:解析用户输入
  93. 从用户输入中拆分出两个要素:
  94. - **位置**:用户指定的中心位置(如"西直门"、"北京南站")
  95. - **搜索类别**:要搜索的内容(如"美食"、"酒店")
  96. | 用户输入 | 位置 | 搜索类别 |
  97. |---------|------|---------|
  98. | 西直门周边美食 | 西直门 | 美食 |
  99. | 北京南站附近酒店 | 北京南站 | 酒店 |
  100. | 天坛周边有什么好吃的 | 天坛 | 美食 |
  101. #### 第二步:检查 API Key
  102. - 如果用户之前未提供过 Key,**先提示用户提供高德 API Key**,等待用户回复后再继续
  103. - 如果用户已提供 Key,直接使用
  104. **请求 Key 的回复模板:**
  105. ```
  106. 🔑 搜索「{位置}」周边的{搜索类别}需要使用高德 API,请提供你的高德开放平台 API Key。
  107. (如果还没有 Key,可以在 https://lbs.amap.com 注册并创建应用获取)
  108. ```
  109. #### 第三步:调用地理编码 API 获取经纬度
  110. **API 格式:**
  111. ```
  112. https://restapi.amap.com/v3/geocode/geo?address={位置}&output=JSON&key={用户的key}&appname=amap-lbs-skill
  113. ```
  114. **执行 curl 请求:**
  115. ```bash
  116. curl -s "https://restapi.amap.com/v3/geocode/geo?address={位置}&output=JSON&key={用户的key}&appname=amap-lbs-skill"
  117. ```
  118. **API 返回示例:**
  119. ```json
  120. {
  121. "status": "1",
  122. "info": "OK",
  123. "geocodes": [
  124. {
  125. "formatted_address": "北京市西城区西直门",
  126. "location": "116.353138,39.939385"
  127. }
  128. ]
  129. }
  130. ```
  131. 从返回结果中提取 `geocodes[0].location`,格式为 `经度,纬度`(如 `116.353138,39.939385`),拆分为:
  132. - **经度(longitude)**:`116.353138`
  133. - **纬度(latitude)**:`39.939385`
  134. #### 第四步:拼接带坐标的搜索链接
  135. **URL 格式:**
  136. ```
  137. https://ditu.amap.com/search?query={搜索类别}&query_type=RQBXY&longitude={经度}&latitude={纬度}&range=1000
  138. ```
  139. - **域名**:`ditu.amap.com`
  140. - **路由**:`/search`
  141. - **参数**:
  142. - `query` = 搜索类别(如"美食")
  143. - `query_type` = `RQBXY`(基于坐标的搜索类型)
  144. - `longitude` = 经度
  145. - `latitude` = 纬度
  146. - `range` = 搜索范围(单位:米,默认 1000)
  147. #### 第五步:返回链接给用户
  148. ### 完整示例
  149. **用户输入:** "搜索西直门周边美食"
  150. 1. 解析:位置 = `西直门`,搜索类别 = `美食`
  151. 2. 调用地理编码 API:`curl -s "https://restapi.amap.com/v3/geocode/geo?address=西直门&output=JSON&key=xxx&appname=amap-lbs-skill"`
  152. 3. 获取坐标:`116.353138,39.939385` → 经度 `116.353138`,纬度 `39.939385`
  153. 4. 拼接链接:`https://ditu.amap.com/search?query=美食&query_type=RQBXY&longitude=116.353138&latitude=39.939385&range=1000`
  154. ### 回复模板
  155. ```
  156. 📍 已查询到「{位置}」的坐标({经度},{纬度}),为你生成周边{搜索类别}的搜索链接:
  157. https://ditu.amap.com/search?query={搜索类别}&query_type=RQBXY&longitude={经度}&latitude={纬度}&range=1000
  158. 点击链接即可查看「{位置}」周边 1 公里内的{搜索类别}。
  159. ```
  160. ---
  161. ## 场景三:热力图展示
  162. 用户有一份包含地理坐标的数据,希望在地图上以热力图的形式可视化展示。
  163. ### 触发条件
  164. 用户提到"热力图"、"数据可视化"、"地图上展示数据"等意图,并提供了数据地址。
  165. ### URL 格式
  166. ```
  167. http://a.amap.com/jsapi_demo_show/static/openclaw/heatmap.html?mapStyle={地图风格}&dataUrl={数据地址(URL编码)}
  168. ```
  169. - **域名**:`a.amap.com`
  170. - **路由**:`/jsapi_demo_show/static/openclaw/heatmap.html`
  171. - **必填参数**:
  172. - `dataUrl` = 用户数据的 URL 地址(**必须进行 URL 编码**)
  173. - `mapStyle` = 地图风格,可选值:
  174. - `grey` — 暗黑地图模式(深色背景,适合展示亮色热力点)
  175. - `light` — 浅色模式(浅色背景,适合日常查看)
  176. ### 执行步骤
  177. 1. **发送埋点统计请求**:在执行操作前,发送以下请求进行埋点统计:
  178. ```bash
  179. curl -s "https://restapi.amap.com/v3/log/init?eventId=skill.call&product=skill_openclaw&platform=JS&label=heatmap&value=call"
  180. 2. **获取数据地址**:从用户输入中提取数据 URL,如果用户未提供,提示用户给出数据地址
  181. 3. **确认地图风格**:询问用户偏好的地图风格(`grey` 或 `light`),如果用户未指定,默认使用 `grey`
  182. 4. **URL 编码**:将数据地址进行 URL 编码(将 `://` → `%3A%2F%2F`,`/` → `%2F` 等)
  183. 5. **拼接链接**:生成完整的热力图 URL
  184. 6. **返回链接给用户**
  185. ### 示例
  186. **用户输入:** "帮我用这份数据生成热力图:`https://a.amap.com/Loca/static/loca-v2/demos/mock_data/hz_house_order.json`,用暗黑模式"
  187. 1. 数据地址:`https://a.amap.com/Loca/static/loca-v2/demos/mock_data/hz_house_order.json`
  188. 2. 地图风格:`grey`
  189. 3. URL 编码后的数据地址:`https%3A%2F%2Fa.amap.com%2FLoca%2Fstatic%2Floca-v2%2Fdemos%2Fmock_data%2Fhz_house_order.json`
  190. 4. 最终链接:
  191. ```
  192. http://a.amap.com/jsapi_demo_show/static/openclaw/heatmap.html?mapStyle=grey&dataUrl=https%3A%2F%2Fa.amap.com%2FLoca%2Fstatic%2Floca-v2%2Fdemos%2Fmock_data%2Fhz_house_order.json
  193. ```
  194. ### 回复模板
  195. ```
  196. 🔥 已为你生成热力图链接:
  197. http://a.amap.com/jsapi_demo_show/static/openclaw/heatmap.html?mapStyle={地图风格}&dataUrl={编码后的数据地址}
  198. 地图风格:{grey/light}
  199. 数据来源:{原始数据地址}
  200. 点击链接即可查看热力图展示。
  201. ```
  202. **请求数据地址的回复模板(用户未提供时):**
  203. ```
  204. 🔥 生成热力图需要你提供数据地址(JSON 格式的 URL),请给出数据链接。
  205. 另外,你希望使用哪种地图风格?
  206. - grey(暗黑模式)
  207. - light(浅色模式)
  208. ```
  209. ---
  210. ## 场景四:POI 详细搜索
  211. 使用高德 Web 服务 API 进行更详细的 POI 搜索,支持更多参数和筛选条件。
  212. ### 执行步骤
  213. 1. **发送埋点统计请求**:在执行操作前,发送以下请求进行埋点统计:
  214. ```bash
  215. curl -s "https://restapi.amap.com/v3/log/init?eventId=skill.call&product=skill_openclaw&platform=JS&label=poi-search&value=call"
  216. ```
  217. 2. **执行 POI 搜索**:根据用户需求调用搜索脚本。
  218. ### 使用方法
  219. ```bash
  220. # 基础搜索
  221. node scripts/poi-search.js --keywords=肯德基 --city=北京
  222. # 搜索更多结果
  223. node scripts/poi-search.js --keywords=餐厅 --city=上海 --page=1 --offset=20
  224. # 周边搜索(需要提供中心点坐标和搜索半径)
  225. node scripts/poi-search.js --keywords=酒店 --location=116.397428,39.90923 --radius=1000
  226. ```
  227. ### 参数说明
  228. | 参数 | 说明 | 必填 | 示例 |
  229. |------|------|------|------|
  230. | `--keywords` | 搜索关键词 | 是 | `--keywords=肯德基` |
  231. | `--city` | 城市名称或编码 | 否 | `--city=北京` |
  232. | `--types` | POI 类型编码 | 否 | `--types=050000` |
  233. | `--location` | 中心点坐标(经度,纬度) | 否 | `--location=116.397428,39.90923` |
  234. | `--radius` | 搜索半径(米) | 否 | `--radius=1000` |
  235. | `--page` | 页码 | 否 | `--page=1` |
  236. | `--offset` | 每页数量(最大25) | 否 | `--offset=10` |
  237. ### 在代码中使用
  238. ```javascript
  239. const { searchPOI } = require('./index');
  240. async function example() {
  241. const result = await searchPOI({
  242. keywords: '咖啡厅',
  243. city: '杭州',
  244. page: 1,
  245. offset: 10
  246. });
  247. if (result && result.pois) {
  248. result.pois.forEach(poi => {
  249. console.log(`${poi.name} - ${poi.address}`);
  250. });
  251. }
  252. }
  253. example();
  254. ```
  255. ---
  256. ## 场景五:路径规划
  257. 规划不同出行方式的路线。
  258. ### 执行步骤
  259. 1. **发送埋点统计请求**:在执行操作前,发送以下请求进行埋点统计:
  260. ```bash
  261. curl -s "https://restapi.amap.com/v3/log/init?eventId=skill.call&product=skill_openclaw&platform=JS&label=route-planning&value=call"
  262. ```
  263. 2. **执行路径规划**:根据用户需求调用路径规划脚本。
  264. ### 使用方法
  265. ```bash
  266. # 步行路线
  267. node scripts/route-planning.js --type=walking --origin=116.397428,39.90923 --destination=116.427281,39.903719
  268. # 驾车路线
  269. node scripts/route-planning.js --type=driving --origin=116.397428,39.90923 --destination=116.427281,39.903719
  270. # 公交路线
  271. node scripts/route-planning.js --type=transfer --origin=116.397428,39.90923 --destination=116.427281,39.903719 --city=北京
  272. ```
  273. ### 路线类型
  274. - `walking` - 步行路线
  275. - `driving` - 驾车路线
  276. - `riding` - 骑行路线
  277. - `transfer` - 公交路线(需要指定城市)
  278. ---
  279. ## 场景六:智能旅游规划
  280. 自动搜索兴趣点并规划游览路线,生成地图可视化链接。
  281. ### 执行步骤
  282. 1. **发送埋点统计请求**:在执行操作前,发送以下请求进行埋点统计:
  283. ```bash
  284. curl -s "https://restapi.amap.com/v3/log/init?eventId=skill.call&product=skill_openclaw&platform=JS&label=travel-planner&value=call"
  285. ```
  286. 2. **执行旅游规划**:根据用户需求调用旅游规划脚本。
  287. ### 使用方法
  288. ```bash
  289. # 基础旅游规划
  290. node scripts/travel-planner.js --city=北京 --interests=景点,美食,酒店
  291. # 指定路线类型(walking/driving/riding/transfer)
  292. node scripts/travel-planner.js --city=杭州 --interests=西湖,美食,茶馆 --routeType=walking
  293. # 驾车游览
  294. node scripts/travel-planner.js --city=上海 --interests=外滩,南京路,城隍庙 --routeType=driving
  295. ```
  296. ### 功能说明
  297. - 自动搜索指定城市的兴趣点(每类最多5个)
  298. - 按顺序规划各兴趣点之间的路线
  299. ---
  300. ## 配置管理
  301. 配置文件位于 `config.json`,包含以下内容:
  302. ```json
  303. {
  304. "webServiceKey": "your_amap_webservice_key_here"
  305. }
  306. ```
  307. 设置 Key 的方式:
  308. 1. **环境变量**:`export AMAP_WEBSERVICE_KEY=your_key`
  309. 2. **命令行参数**:`node index.js your_key`
  310. 3. **自动提示**:首次运行时自动提示输入
  311. 4. **手动编辑**:直接编辑 `config.json` 文件
  312. ---
  313. ## 注意事项
  314. - **场景判断是关键**:区分用户是"直接搜某个东西"、"在某个位置附近搜某个东西"、"规划路线"还是"旅游规划"
  315. - 关键词应尽量精简准确,提取用户真正想搜的内容
  316. - URL 中的中文关键词浏览器会自动处理编码,无需手动 encode
  317. - 场景二、四、五、六需要用户提供高德 API Key,**必须先获取 Key 后再发起请求**,不能跳过
  318. - 如果地理编码 API 返回 `status` 不为 `"1"`,说明请求失败,需提示用户检查 Key 是否正确或地址是否有效
  319. - API 返回的 `location` 格式为 `经度,纬度`(注意:经度在前,纬度在后)
  320. - 场景二的搜索范围默认 1000 米,用户如有需要可调整 `range` 参数
  321. - 请妥善保管你的 Web Service Key,不要分享给他人
  322. - 高德 Web 服务 API 有调用频率限制,请合理使用
  323. - 免费用户每日调用量有限制,具体请查看高德开放平台说明
  324. - 所有 REST API 请求必须追加 `appname=amap-lbs-skill` 参数,用于标识 API 调用来源,禁止省略
  325. ## 相关链接
  326. - [高德开放平台](https://lbs.amap.com/)
  327. - [创建应用和获取 Key](https://lbs.amap.com/api/webservice/create-project-and-key)
  328. - [POI 搜索 API 文档](https://lbs.amap.com/api/webservice/guide/api-advanced/newpoisearch)
  329. - [Web 服务 API 总览](https://lbs.amap.com/api/webservice/summary)
README.md · README · 269 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # 高德地图综合服务 Skill
  2. 高德地图综合服务向开发者提供完整的地图数据服务,包括地点搜索、路径规划、旅游规划和数据可视化等功能。
  3. ## 功能特性
  4. - ✅ 自动管理高德 Web Service Key
  5. - ✅ POI 搜索功能
  6. - ✅ 路径规划(步行、驾车、骑行、公交)
  7. - ✅ 智能旅游规划助手
  8. - ✅ 地图可视化链接生成
  9. - ✅ 热力图数据可视化
  10. - ✅ 支持命令行脚本执行
  11. - ✅ 配置本地持久化
  12. ## 安装依赖
  13. ```bash
  14. npm install
  15. ```
  16. ## 配置 API Key
  17. 首次使用需要配置高德 Web Service Key:
  18. ```bash
  19. # 方式1: 运行时通过环境变量
  20. export AMAP_WEBSERVICE_KEY=your_key
  21. node scripts/poi-search.js --keywords=肯德基 --city=北京
  22. # 方式2: 运行时自动提示输入(会保存到 config.json)
  23. node scripts/poi-search.js --keywords=肯德基 --city=北京
  24. # 方式3: 手动创建配置文件
  25. cp config.example.json config.json
  26. # 然后编辑 config.json 填入你的 Key
  27. ```
  28. 获取 API Key:访问 [高德开放平台](https://lbs.amap.com/api/webservice/create-project-and-key) 创建应用并获取 Key
  29. ## 使用方法
  30. ### 1. POI 搜索
  31. ```bash
  32. # 基础搜索
  33. node scripts/poi-search.js --keywords=肯德基 --city=北京
  34. # 带更多参数的搜索
  35. node scripts/poi-search.js --keywords=餐厅 --city=上海 --page=1 --offset=20
  36. # 周边搜索(需要提供中心点坐标和半径)
  37. node scripts/poi-search.js --keywords=酒店 --location=116.397428,39.90923 --radius=1000
  38. ```
  39. ### 2. 路径规划
  40. ```bash
  41. # 步行路线
  42. node scripts/route-planning.js --type=walking --origin=116.397428,39.90923 --destination=116.427281,39.903719
  43. # 驾车路线(带途经点)
  44. node scripts/route-planning.js --type=driving --origin=116.397428,39.90923 --destination=116.427281,39.903719 --waypoints=116.410000,39.910000
  45. # 骑行路线
  46. node scripts/route-planning.js --type=riding --origin=116.397428,39.90923 --destination=116.427281,39.903719
  47. # 公交路线
  48. node scripts/route-planning.js --type=transfer --origin=116.397428,39.90923 --destination=116.427281,39.903719 --city=北京
  49. ```
  50. ### 3. 智能旅游规划
  51. ```bash
  52. # 基础旅游规划
  53. node scripts/travel-planner.js --city=北京 --interests=景点,美食,酒店
  54. # 指定路线类型
  55. node scripts/travel-planner.js --city=杭州 --interests=西湖,美食,茶馆 --routeType=walking
  56. # 驾车游览
  57. node scripts/travel-planner.js --city=上海 --interests=外滩,南京路,城隍庙 --routeType=driving
  58. ```
  59. ### 4. 在代码中使用
  60. ```javascript
  61. const {
  62. searchPOI,
  63. walkingRoute,
  64. drivingRoute,
  65. travelPlanner,
  66. generateMapLink
  67. } = require('./index');
  68. // POI 搜索
  69. async function searchExample() {
  70. const result = await searchPOI({
  71. keywords: '肯德基',
  72. city: '北京',
  73. page: 1,
  74. offset: 10
  75. });
  76. console.log(result);
  77. }
  78. // 步行路线规划
  79. async function routeExample() {
  80. const result = await walkingRoute({
  81. origin: '116.397428,39.90923',
  82. destination: '116.427281,39.903719'
  83. });
  84. console.log(result);
  85. }
  86. // 旅游规划
  87. async function travelExample() {
  88. const result = await travelPlanner({
  89. city: '北京',
  90. interests: ['景点', '美食', '酒店'],
  91. routeType: 'walking'
  92. });
  93. console.log(result.mapLink); // 地图可视化链接
  94. }
  95. // 生成地图链接
  96. function mapLinkExample() {
  97. const mapData = [
  98. {
  99. type: 'poi',
  100. lnglat: [116.397428, 39.90923],
  101. sort: '风景名胜',
  102. text: '故宫博物院',
  103. remark: '明清两代的皇家宫殿'
  104. },
  105. {
  106. type: 'route',
  107. routeType: 'walking',
  108. start: [116.397428, 39.90923],
  109. end: [116.427281, 39.903719],
  110. remark: '步行路线'
  111. }
  112. ];
  113. const link = generateMapLink(mapData);
  114. console.log(link);
  115. }
  116. ```
  117. ## API 参数说明
  118. ### POI 搜索参数
  119. | 参数 | 类型 | 必填 | 说明 |
  120. |------|------|------|------|
  121. | keywords | string | 是 | 查询关键字 |
  122. | city | string | 否 | 城市名称或城市编码 |
  123. | types | string | 否 | POI类型编码,多个用\|分隔 |
  124. | location | string | 否 | 中心点坐标(经度,纬度) |
  125. | radius | number | 否 | 搜索半径,单位:米 |
  126. | page | number | 否 | 当前页数,默认1 |
  127. | offset | number | 否 | 每页记录数,默认10,最大25 |
  128. ### 路径规划参数
  129. #### 步行路线 (walkingRoute)
  130. | 参数 | 类型 | 必填 | 说明 |
  131. |------|------|------|------|
  132. | origin | string | 是 | 起点坐标 "经度,纬度" |
  133. | destination | string | 是 | 终点坐标 "经度,纬度" |
  134. #### 驾车路线 (drivingRoute)
  135. | 参数 | 类型 | 必填 | 说明 |
  136. |------|------|------|------|
  137. | origin | string | 是 | 起点坐标 "经度,纬度" |
  138. | destination | string | 是 | 终点坐标 "经度,纬度" |
  139. | waypoints | string | 否 | 途经点,多个用;分隔,最多16个 |
  140. | strategy | number | 否 | 驾车策略,默认10(躲避拥堵) |
  141. #### 骑行路线 (ridingRoute)
  142. | 参数 | 类型 | 必填 | 说明 |
  143. |------|------|------|------|
  144. | origin | string | 是 | 起点坐标 "经度,纬度" |
  145. | destination | string | 是 | 终点坐标 "经度,纬度" |
  146. #### 公交路线 (transitRoute)
  147. | 参数 | 类型 | 必填 | 说明 |
  148. |------|------|------|------|
  149. | origin | string | 是 | 起点坐标 "经度,纬度" |
  150. | destination | string | 是 | 终点坐标 "经度,纬度" |
  151. | city | string | 是 | 城市名称或城市编码 |
  152. | strategy | number | 否 | 公交策略,0-5,默认0(最快捷) |
  153. | nightflag | boolean | 否 | 是否计算夜班车,默认false |
  154. ### 旅游规划参数 (travelPlanner)
  155. | 参数 | 类型 | 必填 | 说明 |
  156. |------|------|------|------|
  157. | city | string | 是 | 城市名称 |
  158. | interests | array | 否 | 兴趣点关键词数组,默认['景点','美食'] |
  159. | routeType | string | 否 | 路线类型:walking/driving/riding/transfer,默认walking |
  160. ## 项目结构
  161. ```
  162. jsapi-skills/
  163. ├── index.js # 主入口文件,包含核心功能
  164. ├── scripts/
  165. │ ├── poi-search.js # POI 搜索脚本
  166. │ ├── route-planning.js # 路径规划脚本
  167. │ └── travel-planner.js # 智能旅游规划脚本
  168. ├── config.json # 配置文件(自动生成,不要提交)
  169. ├── config.example.json # 配置示例
  170. ├── package.json # 依赖配置
  171. ├── .gitignore # Git 忽略配置
  172. ├── SKILL.md # OpenClaw Skill 描述文件
  173. └── README.md # 本文件
  174. ```
  175. ## 地图可视化
  176. 所有规划结果都会生成地图可视化链接,格式如下:
  177. ```
  178. https://a.amap.com/jsapi_demo_show/static/openclaw/travel_plan.html?data=<encoded_json_data>
  179. ```
  180. 数据格式符合 MapTaskData 接口规范,支持:
  181. - **POI 任务**:展示兴趣点位置和信息
  182. - **路线任务**:展示路径规划结果
  183. 示例数据结构:
  184. ```javascript
  185. [
  186. // POI 兴趣点
  187. {
  188. type: 'poi',
  189. lnglat: [116.397428, 39.90923],
  190. sort: '风景名胜',
  191. text: '故宫博物院',
  192. remark: '明清两代的皇家宫殿,旧称紫禁城。'
  193. },
  194. // 路线规划
  195. {
  196. type: 'route',
  197. routeType: 'walking',
  198. start: [116.397428, 39.90923],
  199. end: [116.427281, 39.903719],
  200. remark: '步行路线'
  201. }
  202. ]
  203. ```
  204. ## 注意事项
  205. 1. 请妥善保管你的 Web Service Key,不要提交到公开仓库
  206. 2. `config.json` 已在 `.gitignore` 中,不会被提交
  207. 3. 高德 Web 服务 API 有调用频率限制,请合理使用
  208. 4. 免费用户每日调用量有限制,具体请查看高德开放平台说明
  209. ## 相关链接
  210. - [高德开放平台](https://lbs.amap.com/)
  211. - [创建应用和获取 Key](https://lbs.amap.com/api/webservice/create-project-and-key)
  212. - [POI 搜索 API 文档](https://lbs.amap.com/api/webservice/guide/api-advanced/newpoisearch)
  213. - [Web 服务 API 总览](https://lbs.amap.com/api/webservice/summary)
  214. ## License
  215. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.