amap

核心用法

本技能基于高德地图Web服务API，通过curl命令调用六大核心功能：

1. 天气查询 —— 输入城市adcode获取实时天气或7日预报，需配合行政区划查询获取编码。

2. POI地点搜索 —— 关键词+城市定位商铺、景点、设施等，返回名称、地址、电话、坐标。

3. 驾车路径规划 —— 基于经纬度规划最优驾车路线，含距离、耗时、路况及导航步骤。

4. 地理编码 —— 将结构化地址转换为经纬度坐标。

5. 逆地理编码 —— 将坐标反向解析为省市区街道等详细地址。

6. 行政区划查询 —— 获取城市adcode及边界数据，是其他功能的前置依赖。

显著优点

• 数据权威：高德为国民级地图服务商，POI数据覆盖全面，地址解析精准
• 功能闭环：编码/搜索/导航/天气形成完整LBS工作流，可组合调用
• 免费额度：个人开发者享有每日5000-10000次基础调用配额
• 中文原生：全中文地址体系，无翻译损耗

潜在局限

• 需预申请Key：必须手动注册高德开放平台账号，审核通过后方可使用
• adcode依赖：天气等接口不直接识别城市名，需额外查询编码，增加调用链路
• 坐标体系：默认使用GCJ-02国测局坐标，与GPS(WGS-84)存在偏差，跨平台需转换
• 商业限制：免费Key有QPS限制，高频场景需付费升级

适合人群

• 需要中文地址解析与地理位置服务的开发者
• 构建本地生活、出行导航、物流调度类应用的团队
• 快速原型验证阶段不愿接入复杂SDK的轻量用户

常规风险

API Key为明文传输，若在前端暴露或版本控制中泄露，可能导致配额被盗刷。建议通过服务端代理或环境变量隔离管理，并设置Key的白名单IP/Referer限制。

核心功能与使用方式

本技能为纯Markdown文档型技能，提供高德地图Web服务API的标准化调用指南。核心功能包括六类地理信息服务：

1. 天气查询：支持实时天气与3天预报，需通过adcode（行政区划编码）指定城市
2. 地点搜索(POI)：按关键词+城市检索商户、地标等兴趣点
3. 驾车路径规划：输入起终点经纬度获取路线方案
4. 地理编码：将结构化地址转换为经纬度坐标
5. 逆地理编码：将经纬度反向解析为地址描述
6. 行政区划查询：获取省市区adcode及边界信息

使用方式为curl命令模板，用户需预先将高德开放平台申请的Web服务API Key设置为AMAP_KEY环境变量。技能本身无执行代码，仅提供标准化的API调用文档。

显著优点

• 零代码风险：纯Markdown文档，无动态执行、无依赖引入、无本地文件操作
• 官方可信来源：所有7个API端点均为高德地图官方域名（restapi.amap.com），TLS 1.2+加密传输
• 功能实用性强：覆盖日常出行高频场景，curl模板即拿即用
• 隐私合规达标：仅要求功能必需的API Key，不采集系统信息或用户隐私数据
• T2级可信发布：经Clawdbot平台审核发布，来源可信度较高

局限性与潜在缺点

• 需前置配置：必须自行注册高德开放平台账号并申请Key，对新手有门槛
• 中国境内服务：高德API数据覆盖以中国大陆为主，海外场景支持有限
• 配额限制：免费Key有日调用量上限，高频使用需付费升级
• 无错误兜底：文档未提供API异常（网络超时、Key失效、超限）的处理指引
• 坐标系差异：默认返回GCJ-02火星坐标，与WGS-84存在偏差，跨平台对接需注意转换

适合人群

• 需要快速集成地图服务但不想引入SDK的开发者/运维人员
• 命令行重度用户，偏好curl轻量级调用的场景
• 对数据安全敏感、希望代码完全可控的企业环境
• 临时性、脚本化的地理位置查询需求

常规风险提示

• API Key泄露风险：环境变量模式虽比硬编码安全，但仍需避免提交到Git仓库或共享终端
• 依赖外部服务可用性：高德服务器故障或网络波动将直接影响功能
• 商业授权边界：部分API（如路径规划）有商业用途限制，需仔细阅读高德服务条款
• 输入验证缺失：技能本身不校验地址/坐标格式有效性，错误输入将导致API报错

综合评估：S级安全评分的实用型工具技能，适合作为地图服务的快速接入方案，但生产环境建议补充错误处理和监控机制。