amap

核心用法

本技能通过调用高德地图Web服务API，为Agent提供完整的地理位置服务能力。用户需先在高德开放平台申请Web服务API Key并设置为AMAP_KEY环境变量。技能涵盖六大核心功能：天气查询（实时/预报）、地点搜索（POI）、驾车路径规划、地理编码（地址转坐标）、逆地理编码（坐标转地址）以及行政区划查询（获取adcode）。所有功能均通过标准curl命令发起HTTP GET请求实现，返回JSON格式数据供后续处理。

显著优点

官方API背书：直接对接高德地图官方服务，数据准确性和稳定性有保障，覆盖中国大陆地区详细的POI数据和实时交通信息。功能覆盖全面：从基础天气查询到复杂的路径规划，满足日常LBS需求的一站式解决方案。零代码侵入：技能本身无实际执行代码，仅提供标准化调用文档，用户可完全掌控请求过程。轻量依赖：仅需系统标准工具curl，无需安装额外运行时或第三方库。触发条件明确：文档清晰定义了天气、搜索、导航等典型使用场景，降低Agent决策成本。

潜在缺点与局限性

地域限制明显：高德地图API主要覆盖中国大陆，海外数据支持有限，不适合国际化场景。坐标系统特殊：默认使用GCJ-02火星坐标系，与WGS-84（GPS）存在偏差，跨平台数据融合需注意转换。配额与成本：免费Key有日调用量限制（如天气API 5000次/天），高频使用需购买商用套餐。多步骤操作：部分功能需链式调用（如先查adcode再查天气），增加交互复杂度。无内置缓存：重复查询会消耗配额，需用户自行实现缓存策略。

适合的目标群体

• 本地生活类Agent：需要查询天气、周边设施、导航路线的智能助手
• 物流/出行规划工具：涉及地址解析、路径计算的业务系统
• 数据分析师：需要批量地理编码或行政区划数据的研究场景
• 快速原型开发者：验证LBS功能idea时无需搭建地图服务基础设施

使用风险

API Key泄露风险：AMAP_KEY以环境变量形式暴露，多用户共享环境时存在盗用可能，建议配合密钥管理服务。服务可用性依赖：完全依赖高德服务器状态，官方服务中断或限流将直接影响功能。数据合规注意：地理位置信息属于敏感数据，商用场景需遵守《个人信息保护法》及高德平台使用协议。配额耗尽导致故障：未监控用量时可能触发限流，建议生产环境添加配额预警机制。