核心用法
LovTrip 高德地图助手是一套专为中国大陆场景设计的地理信息工具集，通过 MCP Server 调用高德 REST API，覆盖地理编码、逆地理编码、周边 POI 搜索、路线规划、地点详情查询及多平台地图链接生成六大功能。使用前需配置 AMAP_API_KEY，推荐通过 npx -y lovtrip@latest mcp 启动 MCP Server；若 MCP 不可用，可直接调用 scripts/amap.sh 作为兜底方案。
典型工作流为：先以 amap_geocode 将中文地址转为坐标（务必传入 city 参数以提升精度），再用 amap_search_nearby 检索周边兴趣点，通过 get_venue_details 获取营业时间、评分、价格等深度信息，最后以 generate_map_links 生成高德、腾讯、百度、Apple Maps 的跳转链接。路线规划支持公交、驾车、步行三种模式，返回距离、时长及费用估算。
显著优点
- 本土数据精度高：依托高德地图在中国大陆 POI 覆盖与实时路况优势，地址解析与路线计算准确性显著优于国际通用地图服务。
- 多平台链接一键生成：自动适配高德、腾讯、百度、Apple Maps 深度链接，便于跨生态分享导航。
- 工作流闭环完整：从地址查询到详情获取再到导航分享，六步工具形成端到端体验，减少用户切换成本。
- 兜底机制健全：MCP 故障时可通过 shell 脚本直连 API，保障服务连续性。
潜在缺点与局限性
- 地理范围严格受限：仅支持 73.5–135.0°E、18.0–53.5°N 坐标，港澳台及海外地点需切换至
lovtrip-global-planner（Google Places API）。 - 商业 API 依赖：需用户自行申请并管理高德 Key，存在配额与计费风险；Key 泄露可能导致额度盗刷。
- 批量处理能力有限：单次最多处理 10 个地址，大规模数据清洗需分批调用。
- AI 生成内容边界：路线与 POI 信息均源自高德官方数据，但 LovTrip 平台本身为 AI 旅行规划产品，需区分工具输出与平台生成内容的可信度。
适合人群
- 需在中国大陆进行地址解析、地点搜索或路线规划的开发者与终端用户；
- 希望快速生成多平台地图跳转链接的运营、出行、本地生活类应用开发者；
- 已使用或计划接入 LovTrip AI 旅行规划生态的 Claude Code 用户。
常规风险
- API Key 安全：
AMAP_API_KEY以环境变量注入，需避免硬编码或日志泄露；建议启用高德后台的 IP/Referer 白名单及配额告警。 - 地理合规与数据出境：高德地图数据属中国境内测绘成果，跨境传输需符合《测绘法》及数据安全法规；境外服务器调用需谨慎评估。
- 服务可用性：依赖高德开放平台 SLA，高峰期可能出现限流；关键业务建议实现指数退避重试。
- 坐标系差异：高德采用 GCJ-02 火星坐标系，与 WGS-84、BD-09 存在偏移，跨系统对接时需注意坐标转换。