核心用法
amap-lbs-skill 是面向高德地图开放平台的综合服务 Skill,支持六类核心场景:
1. 关键词搜索:直接生成 amap.com/search?query= 链接,适用于美食、酒店、景点等通用搜索
2. 周边搜索:基于地理编码 API 获取坐标后,生成带经纬度的精准周边检索链接(需 API Key)
3. 热力图可视化:将 JSON 数据地址编码后生成可视化页面,支持 grey/light 两种地图风格
4. POI 详细搜索:通过 Node 脚本调用 /v3/place/text 接口,支持城市筛选、类型编码、分页控制
5. 路径规划:支持步行、驾车、骑行、公交四种出行方式,需传入起终点坐标
6. 智能旅游规划:自动聚合多类兴趣点并按顺序规划游览路线
配置方式灵活,支持环境变量 AMAP_WEBSERVICE_KEY、命令行参数、本地 config.json 持久化存储及交互式输入。
显著优点
- 官方权威:直接对接高德 Web Service API,数据实时准确,覆盖国内 600+ 城市
- 场景覆盖全:从简单搜索到复杂数据可视化、旅游路线规划,满足 C 端与 B 端多元需求
- 配置友好:Key 管理自动化,支持首次运行引导输入并持久化,降低使用门槛
- 输出格式丰富:既可直接返回浏览器可打开的高德地图链接,也可通过脚本输出结构化 JSON
潜在缺点与局限性
- 强依赖 API Key:场景二、四、五、六必须配置
AMAP_WEBSERVICE_KEY,免费账号有日调用量限制(个人开发者 5000-10000 次/日) - 坐标格式易混淆:API 返回
经度,纬度,与部分 GIS 系统纬度,经度习惯相反,需特别注意 - 热力图需外置数据:仅支持通过 URL 引用外部 JSON,无法直接接收本地文件或内存数据
- 公交规划限制:需额外指定城市参数,跨城规划能力有限
- Key 安全风险:虽支持本地存储,但 Node 脚本执行环境若未隔离,存在 Key 泄露风险
适合人群
- 需要快速集成地图搜索、路线规划能力的开发者与效率工具用户
- 数据分析师(热力图可视化场景)
- 本地生活服务、OTA、出行类应用的快速原型搭建
常规风险
- Key 滥用/泄露:Web Service Key 属于敏感凭证,泄露可能导致配额被刷或账号封禁
- 频率限制触发:高频调用易触发 429 错误,生产环境需配置限流与降级策略
- 数据合规性:热力图数据源需确保合法合规,避免敏感位置信息泄露