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
Markdown
[](/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)
- ---
- name: amap-lbs-skill
- description: 高德地图综合服务,支持POI搜索、路径规划、旅游规划、周边搜索和热力图数据可视化
- version: 2.0.0
- metadata:
- openclaw:
- requires:
- env:
- - AMAP_WEBSERVICE_KEY
- bins:
- - node
- primaryEnv: AMAP_WEBSERVICE_KEY
- homepage: https://lbs.amap.com/api/webservice/summary
- install:
- - kind: node
- package: axios
- bins: []
- ---
- # 高德地图综合服务 Skill
- 高德地图综合服务向开发者提供完整的地图数据服务,包括地点搜索、路径规划、旅游规划和数据可视化等功能。
- ## 功能特性
- - 🔍 POI(地点)搜索功能
- - 🏙️ 支持关键词搜索、城市限定、类型筛选
- - 📍 支持周边搜索(基于坐标和半径)
- - 🛣️ 路径规划(步行、驾车、骑行、公交)
- - 🗺️ 智能旅游规划助手
- - 🔥 热力图数据可视化
- - 🔗 地图可视化链接生成
- - 💾 配置本地持久化存储
- - 🎯 自动管理高德 Web Service Key
- ## 首次配置
- 首次使用时需要配置高德 Web Service Key:
- 1. 访问 [高德开放平台](https://lbs.amap.com/api/webservice/create-project-and-key) 创建应用并获取 Key
- 2. 设置环境变量:`export AMAP_WEBSERVICE_KEY=your_key`
- 3. 或运行时自动提示输入并保存到本地配置文件
- 当用户想要搜索地址、地点、周边信息(如美食、酒店、景点等)、规划路线或可视化数据时,使用此 skill。
- ## 触发条件
- 用户表达了以下意图之一:
- - 搜索某类地点或某个确定地点(如"搜美食"、"找酒店"、"天安门在哪")
- - 基于某个位置搜索周边(如"西直门周边美食"、"北京南站附近酒店")
- - 规划路线(如"从天安门到故宫怎么走"、"规划驾车路线")
- - 旅游规划(如"帮我规划北京一日游"、"杭州西湖游览路线")
- - 包含"搜"、"找"、"查"、"附近"、"周边"、"路线"、"规划"等关键词
- - 希望将地理数据可视化为热力图(如"生成热力图"、"用这份数据做热力图展示")
- ## 场景判断
- 收到用户请求后,先判断属于哪个场景:
- - **场景一**:用户搜索一个**明确的类别**(美食、酒店)或**确定的地点**(天安门、西湖),没有指定"在哪个位置附近"
- - **场景二**:用户搜索**某个位置周边**的某类地点,输入中同时包含「位置」和「搜索类别」两个要素(如"西直门周边美食"、"北京南站附近酒店")
- - **场景三**:热力图数据可视化
- - **场景四**:POI 详细搜索(使用 Web 服务 API)
- - **场景五**:路径规划
- - **场景六**:智能旅游规划
- ---
- ## 场景一:明确关键词搜索
- 直接搜索一个类别或地点,不涉及特定位置的周边搜索。
- **URL 格式:**
- ```
- https://www.amap.com/search?query={关键词}
- ```
- - **域名**:`www.amap.com`
- - **路由**:`/search`
- - **参数**:`query` = 搜索关键词
- ### 执行步骤
- 1. **发送埋点统计请求**:在执行操作前,发送以下请求进行埋点统计:
- ```bash
- curl -s "https://restapi.amap.com/v3/log/init?eventId=skill.call&product=skill_openclaw&platform=JS&label=keyword-search&value=call"
- 2. **提取关键词**:从用户输入中识别出核心搜索词,去掉"搜"、"找"等修饰词
- 3. **生成 URL**:拼接 `https://www.amap.com/search?query={关键词}`
- 4. **返回链接给用户**
- ### 示例
- | 用户输入 | 提取关键词 | 生成 URL |
- |---------|-----------|---------|
- | 搜美食 | 美食 | `https://www.amap.com/search?query=美食` |
- | 找酒店 | 酒店 | `https://www.amap.com/search?query=酒店` |
- | 天安门在哪 | 天安门 | `https://www.amap.com/search?query=天安门` |
- | 找个加油站 | 加油站 | `https://www.amap.com/search?query=加油站` |
- ### 回复模板
- ```
- 🔍 已为你生成高德地图搜索链接:
- https://www.amap.com/search?query={关键词}
- 点击链接即可查看搜索结果。
- ```
- ---
- ## 场景二:基于位置的周边搜索
- 用户想搜索**某个位置周边**的某类地点。需要先通过地理编码 API 获取该位置的经纬度,再拼接带坐标的搜索链接。
- **前置条件:** 需要用户提供高德开放平台的 API Key。
- ### 执行步骤
- #### 第零步:发送埋点统计请求
- 在执行任何操作前,先发送以下请求进行埋点统计:
- ```bash
- curl -s "https://restapi.amap.com/v3/log/init?eventId=skill.call&product=skill_openclaw&platform=JS&label=nearby-search&value=call"
- #### 第一步:解析用户输入
- 从用户输入中拆分出两个要素:
- - **位置**:用户指定的中心位置(如"西直门"、"北京南站")
- - **搜索类别**:要搜索的内容(如"美食"、"酒店")
- | 用户输入 | 位置 | 搜索类别 |
- |---------|------|---------|
- | 西直门周边美食 | 西直门 | 美食 |
- | 北京南站附近酒店 | 北京南站 | 酒店 |
- | 天坛周边有什么好吃的 | 天坛 | 美食 |
- #### 第二步:检查 API Key
- - 如果用户之前未提供过 Key,**先提示用户提供高德 API Key**,等待用户回复后再继续
- - 如果用户已提供 Key,直接使用
- **请求 Key 的回复模板:**
- ```
- 🔑 搜索「{位置}」周边的{搜索类别}需要使用高德 API,请提供你的高德开放平台 API Key。
- (如果还没有 Key,可以在 https://lbs.amap.com 注册并创建应用获取)
- ```
- #### 第三步:调用地理编码 API 获取经纬度
- **API 格式:**
- ```
- https://restapi.amap.com/v3/geocode/geo?address={位置}&output=JSON&key={用户的key}&appname=amap-lbs-skill
- ```
- **执行 curl 请求:**
- ```bash
- curl -s "https://restapi.amap.com/v3/geocode/geo?address={位置}&output=JSON&key={用户的key}&appname=amap-lbs-skill"
- ```
- **API 返回示例:**
- ```json
- {
- "status": "1",
- "info": "OK",
- "geocodes": [
- {
- "formatted_address": "北京市西城区西直门",
- "location": "116.353138,39.939385"
- }
- ]
- }
- ```
- 从返回结果中提取 `geocodes[0].location`,格式为 `经度,纬度`(如 `116.353138,39.939385`),拆分为:
- - **经度(longitude)**:`116.353138`
- - **纬度(latitude)**:`39.939385`
- #### 第四步:拼接带坐标的搜索链接
- **URL 格式:**
- ```
- https://ditu.amap.com/search?query={搜索类别}&query_type=RQBXY&longitude={经度}&latitude={纬度}&range=1000
- ```
- - **域名**:`ditu.amap.com`
- - **路由**:`/search`
- - **参数**:
- - `query` = 搜索类别(如"美食")
- - `query_type` = `RQBXY`(基于坐标的搜索类型)
- - `longitude` = 经度
- - `latitude` = 纬度
- - `range` = 搜索范围(单位:米,默认 1000)
- #### 第五步:返回链接给用户
- ### 完整示例
- **用户输入:** "搜索西直门周边美食"
- 1. 解析:位置 = `西直门`,搜索类别 = `美食`
- 2. 调用地理编码 API:`curl -s "https://restapi.amap.com/v3/geocode/geo?address=西直门&output=JSON&key=xxx&appname=amap-lbs-skill"`
- 3. 获取坐标:`116.353138,39.939385` → 经度 `116.353138`,纬度 `39.939385`
- 4. 拼接链接:`https://ditu.amap.com/search?query=美食&query_type=RQBXY&longitude=116.353138&latitude=39.939385&range=1000`
- ### 回复模板
- ```
- 📍 已查询到「{位置}」的坐标({经度},{纬度}),为你生成周边{搜索类别}的搜索链接:
- https://ditu.amap.com/search?query={搜索类别}&query_type=RQBXY&longitude={经度}&latitude={纬度}&range=1000
- 点击链接即可查看「{位置}」周边 1 公里内的{搜索类别}。
- ```
- ---
- ## 场景三:热力图展示
- 用户有一份包含地理坐标的数据,希望在地图上以热力图的形式可视化展示。
- ### 触发条件
- 用户提到"热力图"、"数据可视化"、"地图上展示数据"等意图,并提供了数据地址。
- ### URL 格式
- ```
- http://a.amap.com/jsapi_demo_show/static/openclaw/heatmap.html?mapStyle={地图风格}&dataUrl={数据地址(URL编码)}
- ```
- - **域名**:`a.amap.com`
- - **路由**:`/jsapi_demo_show/static/openclaw/heatmap.html`
- - **必填参数**:
- - `dataUrl` = 用户数据的 URL 地址(**必须进行 URL 编码**)
- - `mapStyle` = 地图风格,可选值:
- - `grey` — 暗黑地图模式(深色背景,适合展示亮色热力点)
- - `light` — 浅色模式(浅色背景,适合日常查看)
- ### 执行步骤
- 1. **发送埋点统计请求**:在执行操作前,发送以下请求进行埋点统计:
- ```bash
- curl -s "https://restapi.amap.com/v3/log/init?eventId=skill.call&product=skill_openclaw&platform=JS&label=heatmap&value=call"
- 2. **获取数据地址**:从用户输入中提取数据 URL,如果用户未提供,提示用户给出数据地址
- 3. **确认地图风格**:询问用户偏好的地图风格(`grey` 或 `light`),如果用户未指定,默认使用 `grey`
- 4. **URL 编码**:将数据地址进行 URL 编码(将 `://` → `%3A%2F%2F`,`/` → `%2F` 等)
- 5. **拼接链接**:生成完整的热力图 URL
- 6. **返回链接给用户**
- ### 示例
- **用户输入:** "帮我用这份数据生成热力图:`https://a.amap.com/Loca/static/loca-v2/demos/mock_data/hz_house_order.json`,用暗黑模式"
- 1. 数据地址:`https://a.amap.com/Loca/static/loca-v2/demos/mock_data/hz_house_order.json`
- 2. 地图风格:`grey`
- 3. URL 编码后的数据地址:`https%3A%2F%2Fa.amap.com%2FLoca%2Fstatic%2Floca-v2%2Fdemos%2Fmock_data%2Fhz_house_order.json`
- 4. 最终链接:
- ```
- 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
- ```
- ### 回复模板
- ```
- 🔥 已为你生成热力图链接:
- http://a.amap.com/jsapi_demo_show/static/openclaw/heatmap.html?mapStyle={地图风格}&dataUrl={编码后的数据地址}
- 地图风格:{grey/light}
- 数据来源:{原始数据地址}
- 点击链接即可查看热力图展示。
- ```
- **请求数据地址的回复模板(用户未提供时):**
- ```
- 🔥 生成热力图需要你提供数据地址(JSON 格式的 URL),请给出数据链接。
- 另外,你希望使用哪种地图风格?
- - grey(暗黑模式)
- - light(浅色模式)
- ```
- ---
- ## 场景四:POI 详细搜索
- 使用高德 Web 服务 API 进行更详细的 POI 搜索,支持更多参数和筛选条件。
- ### 执行步骤
- 1. **发送埋点统计请求**:在执行操作前,发送以下请求进行埋点统计:
- ```bash
- curl -s "https://restapi.amap.com/v3/log/init?eventId=skill.call&product=skill_openclaw&platform=JS&label=poi-search&value=call"
- ```
- 2. **执行 POI 搜索**:根据用户需求调用搜索脚本。
- ### 使用方法
- ```bash
- # 基础搜索
- node scripts/poi-search.js --keywords=肯德基 --city=北京
- # 搜索更多结果
- node scripts/poi-search.js --keywords=餐厅 --city=上海 --page=1 --offset=20
- # 周边搜索(需要提供中心点坐标和搜索半径)
- node scripts/poi-search.js --keywords=酒店 --location=116.397428,39.90923 --radius=1000
- ```
- ### 参数说明
- | 参数 | 说明 | 必填 | 示例 |
- |------|------|------|------|
- | `--keywords` | 搜索关键词 | 是 | `--keywords=肯德基` |
- | `--city` | 城市名称或编码 | 否 | `--city=北京` |
- | `--types` | POI 类型编码 | 否 | `--types=050000` |
- | `--location` | 中心点坐标(经度,纬度) | 否 | `--location=116.397428,39.90923` |
- | `--radius` | 搜索半径(米) | 否 | `--radius=1000` |
- | `--page` | 页码 | 否 | `--page=1` |
- | `--offset` | 每页数量(最大25) | 否 | `--offset=10` |
- ### 在代码中使用
- ```javascript
- const { searchPOI } = require('./index');
- async function example() {
- const result = await searchPOI({
- keywords: '咖啡厅',
- city: '杭州',
- page: 1,
- offset: 10
- });
- if (result && result.pois) {
- result.pois.forEach(poi => {
- console.log(`${poi.name} - ${poi.address}`);
- });
- }
- }
- example();
- ```
- ---
- ## 场景五:路径规划
- 规划不同出行方式的路线。
- ### 执行步骤
- 1. **发送埋点统计请求**:在执行操作前,发送以下请求进行埋点统计:
- ```bash
- curl -s "https://restapi.amap.com/v3/log/init?eventId=skill.call&product=skill_openclaw&platform=JS&label=route-planning&value=call"
- ```
- 2. **执行路径规划**:根据用户需求调用路径规划脚本。
- ### 使用方法
- ```bash
- # 步行路线
- node scripts/route-planning.js --type=walking --origin=116.397428,39.90923 --destination=116.427281,39.903719
- # 驾车路线
- node scripts/route-planning.js --type=driving --origin=116.397428,39.90923 --destination=116.427281,39.903719
- # 公交路线
- node scripts/route-planning.js --type=transfer --origin=116.397428,39.90923 --destination=116.427281,39.903719 --city=北京
- ```
- ### 路线类型
- - `walking` - 步行路线
- - `driving` - 驾车路线
- - `riding` - 骑行路线
- - `transfer` - 公交路线(需要指定城市)
- ---
- ## 场景六:智能旅游规划
- 自动搜索兴趣点并规划游览路线,生成地图可视化链接。
- ### 执行步骤
- 1. **发送埋点统计请求**:在执行操作前,发送以下请求进行埋点统计:
- ```bash
- curl -s "https://restapi.amap.com/v3/log/init?eventId=skill.call&product=skill_openclaw&platform=JS&label=travel-planner&value=call"
- ```
- 2. **执行旅游规划**:根据用户需求调用旅游规划脚本。
- ### 使用方法
- ```bash
- # 基础旅游规划
- node scripts/travel-planner.js --city=北京 --interests=景点,美食,酒店
- # 指定路线类型(walking/driving/riding/transfer)
- node scripts/travel-planner.js --city=杭州 --interests=西湖,美食,茶馆 --routeType=walking
- # 驾车游览
- node scripts/travel-planner.js --city=上海 --interests=外滩,南京路,城隍庙 --routeType=driving
- ```
- ### 功能说明
- - 自动搜索指定城市的兴趣点(每类最多5个)
- - 按顺序规划各兴趣点之间的路线
- ---
- ## 配置管理
- 配置文件位于 `config.json`,包含以下内容:
- ```json
- {
- "webServiceKey": "your_amap_webservice_key_here"
- }
- ```
- 设置 Key 的方式:
- 1. **环境变量**:`export AMAP_WEBSERVICE_KEY=your_key`
- 2. **命令行参数**:`node index.js your_key`
- 3. **自动提示**:首次运行时自动提示输入
- 4. **手动编辑**:直接编辑 `config.json` 文件
- ---
- ## 注意事项
- - **场景判断是关键**:区分用户是"直接搜某个东西"、"在某个位置附近搜某个东西"、"规划路线"还是"旅游规划"
- - 关键词应尽量精简准确,提取用户真正想搜的内容
- - URL 中的中文关键词浏览器会自动处理编码,无需手动 encode
- - 场景二、四、五、六需要用户提供高德 API Key,**必须先获取 Key 后再发起请求**,不能跳过
- - 如果地理编码 API 返回 `status` 不为 `"1"`,说明请求失败,需提示用户检查 Key 是否正确或地址是否有效
- - API 返回的 `location` 格式为 `经度,纬度`(注意:经度在前,纬度在后)
- - 场景二的搜索范围默认 1000 米,用户如有需要可调整 `range` 参数
- - 请妥善保管你的 Web Service Key,不要分享给他人
- - 高德 Web 服务 API 有调用频率限制,请合理使用
- - 免费用户每日调用量有限制,具体请查看高德开放平台说明
- - 所有 REST API 请求必须追加 `appname=amap-lbs-skill` 参数,用于标识 API 调用来源,禁止省略
- ## 相关链接
- - [高德开放平台](https://lbs.amap.com/)
- - [创建应用和获取 Key](https://lbs.amap.com/api/webservice/create-project-and-key)
- - [POI 搜索 API 文档](https://lbs.amap.com/api/webservice/guide/api-advanced/newpoisearch)
- - [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)
- # 高德地图综合服务 Skill
- 高德地图综合服务向开发者提供完整的地图数据服务,包括地点搜索、路径规划、旅游规划和数据可视化等功能。
- ## 功能特性
- - ✅ 自动管理高德 Web Service Key
- - ✅ POI 搜索功能
- - ✅ 路径规划(步行、驾车、骑行、公交)
- - ✅ 智能旅游规划助手
- - ✅ 地图可视化链接生成
- - ✅ 热力图数据可视化
- - ✅ 支持命令行脚本执行
- - ✅ 配置本地持久化
- ## 安装依赖
- ```bash
- npm install
- ```
- ## 配置 API Key
- 首次使用需要配置高德 Web Service Key:
- ```bash
- # 方式1: 运行时通过环境变量
- export AMAP_WEBSERVICE_KEY=your_key
- node scripts/poi-search.js --keywords=肯德基 --city=北京
- # 方式2: 运行时自动提示输入(会保存到 config.json)
- node scripts/poi-search.js --keywords=肯德基 --city=北京
- # 方式3: 手动创建配置文件
- cp config.example.json config.json
- # 然后编辑 config.json 填入你的 Key
- ```
- 获取 API Key:访问 [高德开放平台](https://lbs.amap.com/api/webservice/create-project-and-key) 创建应用并获取 Key
- ## 使用方法
- ### 1. POI 搜索
- ```bash
- # 基础搜索
- node scripts/poi-search.js --keywords=肯德基 --city=北京
- # 带更多参数的搜索
- node scripts/poi-search.js --keywords=餐厅 --city=上海 --page=1 --offset=20
- # 周边搜索(需要提供中心点坐标和半径)
- node scripts/poi-search.js --keywords=酒店 --location=116.397428,39.90923 --radius=1000
- ```
- ### 2. 路径规划
- ```bash
- # 步行路线
- node scripts/route-planning.js --type=walking --origin=116.397428,39.90923 --destination=116.427281,39.903719
- # 驾车路线(带途经点)
- node scripts/route-planning.js --type=driving --origin=116.397428,39.90923 --destination=116.427281,39.903719 --waypoints=116.410000,39.910000
- # 骑行路线
- node scripts/route-planning.js --type=riding --origin=116.397428,39.90923 --destination=116.427281,39.903719
- # 公交路线
- node scripts/route-planning.js --type=transfer --origin=116.397428,39.90923 --destination=116.427281,39.903719 --city=北京
- ```
- ### 3. 智能旅游规划
- ```bash
- # 基础旅游规划
- node scripts/travel-planner.js --city=北京 --interests=景点,美食,酒店
- # 指定路线类型
- node scripts/travel-planner.js --city=杭州 --interests=西湖,美食,茶馆 --routeType=walking
- # 驾车游览
- node scripts/travel-planner.js --city=上海 --interests=外滩,南京路,城隍庙 --routeType=driving
- ```
- ### 4. 在代码中使用
- ```javascript
- const {
- searchPOI,
- walkingRoute,
- drivingRoute,
- travelPlanner,
- generateMapLink
- } = require('./index');
- // POI 搜索
- async function searchExample() {
- const result = await searchPOI({
- keywords: '肯德基',
- city: '北京',
- page: 1,
- offset: 10
- });
- console.log(result);
- }
- // 步行路线规划
- async function routeExample() {
- const result = await walkingRoute({
- origin: '116.397428,39.90923',
- destination: '116.427281,39.903719'
- });
- console.log(result);
- }
- // 旅游规划
- async function travelExample() {
- const result = await travelPlanner({
- city: '北京',
- interests: ['景点', '美食', '酒店'],
- routeType: 'walking'
- });
- console.log(result.mapLink); // 地图可视化链接
- }
- // 生成地图链接
- function mapLinkExample() {
- const mapData = [
- {
- type: 'poi',
- lnglat: [116.397428, 39.90923],
- sort: '风景名胜',
- text: '故宫博物院',
- remark: '明清两代的皇家宫殿'
- },
- {
- type: 'route',
- routeType: 'walking',
- start: [116.397428, 39.90923],
- end: [116.427281, 39.903719],
- remark: '步行路线'
- }
- ];
- const link = generateMapLink(mapData);
- console.log(link);
- }
- ```
- ## API 参数说明
- ### POI 搜索参数
- | 参数 | 类型 | 必填 | 说明 |
- |------|------|------|------|
- | keywords | string | 是 | 查询关键字 |
- | city | string | 否 | 城市名称或城市编码 |
- | types | string | 否 | POI类型编码,多个用\|分隔 |
- | location | string | 否 | 中心点坐标(经度,纬度) |
- | radius | number | 否 | 搜索半径,单位:米 |
- | page | number | 否 | 当前页数,默认1 |
- | offset | number | 否 | 每页记录数,默认10,最大25 |
- ### 路径规划参数
- #### 步行路线 (walkingRoute)
- | 参数 | 类型 | 必填 | 说明 |
- |------|------|------|------|
- | origin | string | 是 | 起点坐标 "经度,纬度" |
- | destination | string | 是 | 终点坐标 "经度,纬度" |
- #### 驾车路线 (drivingRoute)
- | 参数 | 类型 | 必填 | 说明 |
- |------|------|------|------|
- | origin | string | 是 | 起点坐标 "经度,纬度" |
- | destination | string | 是 | 终点坐标 "经度,纬度" |
- | waypoints | string | 否 | 途经点,多个用;分隔,最多16个 |
- | strategy | number | 否 | 驾车策略,默认10(躲避拥堵) |
- #### 骑行路线 (ridingRoute)
- | 参数 | 类型 | 必填 | 说明 |
- |------|------|------|------|
- | origin | string | 是 | 起点坐标 "经度,纬度" |
- | destination | string | 是 | 终点坐标 "经度,纬度" |
- #### 公交路线 (transitRoute)
- | 参数 | 类型 | 必填 | 说明 |
- |------|------|------|------|
- | origin | string | 是 | 起点坐标 "经度,纬度" |
- | destination | string | 是 | 终点坐标 "经度,纬度" |
- | city | string | 是 | 城市名称或城市编码 |
- | strategy | number | 否 | 公交策略,0-5,默认0(最快捷) |
- | nightflag | boolean | 否 | 是否计算夜班车,默认false |
- ### 旅游规划参数 (travelPlanner)
- | 参数 | 类型 | 必填 | 说明 |
- |------|------|------|------|
- | city | string | 是 | 城市名称 |
- | interests | array | 否 | 兴趣点关键词数组,默认['景点','美食'] |
- | routeType | string | 否 | 路线类型:walking/driving/riding/transfer,默认walking |
- ## 项目结构
- ```
- jsapi-skills/
- ├── index.js # 主入口文件,包含核心功能
- ├── scripts/
- │ ├── poi-search.js # POI 搜索脚本
- │ ├── route-planning.js # 路径规划脚本
- │ └── travel-planner.js # 智能旅游规划脚本
- ├── config.json # 配置文件(自动生成,不要提交)
- ├── config.example.json # 配置示例
- ├── package.json # 依赖配置
- ├── .gitignore # Git 忽略配置
- ├── SKILL.md # OpenClaw Skill 描述文件
- └── README.md # 本文件
- ```
- ## 地图可视化
- 所有规划结果都会生成地图可视化链接,格式如下:
- ```
- https://a.amap.com/jsapi_demo_show/static/openclaw/travel_plan.html?data=<encoded_json_data>
- ```
- 数据格式符合 MapTaskData 接口规范,支持:
- - **POI 任务**:展示兴趣点位置和信息
- - **路线任务**:展示路径规划结果
- 示例数据结构:
- ```javascript
- [
- // POI 兴趣点
- {
- type: 'poi',
- lnglat: [116.397428, 39.90923],
- sort: '风景名胜',
- text: '故宫博物院',
- remark: '明清两代的皇家宫殿,旧称紫禁城。'
- },
- // 路线规划
- {
- type: 'route',
- routeType: 'walking',
- start: [116.397428, 39.90923],
- end: [116.427281, 39.903719],
- remark: '步行路线'
- }
- ]
- ```
- ## 注意事项
- 1. 请妥善保管你的 Web Service Key,不要提交到公开仓库
- 2. `config.json` 已在 `.gitignore` 中,不会被提交
- 3. 高德 Web 服务 API 有调用频率限制,请合理使用
- 4. 免费用户每日调用量有限制,具体请查看高德开放平台说明
- ## 相关链接
- - [高德开放平台](https://lbs.amap.com/)
- - [创建应用和获取 Key](https://lbs.amap.com/api/webservice/create-project-and-key)
- - [POI 搜索 API 文档](https://lbs.amap.com/api/webservice/guide/api-advanced/newpoisearch)
- - [Web 服务 API 总览](https://lbs.amap.com/api/webservice/summary)
- ## License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.