核心用法
Maps 技能提供了一套基于命令行的地理服务工具，核心功能分为两大模块：
地理编码 (Geocoding)：通过 geocode.sh 脚本将自然语言地址转换为经纬度坐标，底层调用 OpenStreetMap 的 Nominatim 服务。典型用法如 bash scripts/geocode.sh "Times Square, New York"，返回包含标准地名、纬度、经度的结构化数据。
路线规划 (Routing)：通过 distance.sh 脚本计算两点间的距离与预估行程时间，底层调用 OSRM（Open Source Routing Machine）公共演示服务器。支持三种交通模式：driving（驾车，默认）、foot（步行）、bicycle（骑行）。坐标格式为 lat,lon，如 40.7580,-73.9855。
标准工作流为先对地址进行地理编码，获取坐标后再执行路线计算，最后以公里和分钟为单位呈现结果。
显著优点
- 零成本准入：完全依赖开源基础设施，无需注册账号或申请 API 密钥
- 隐私友好：请求直接发送至公共 OSM 服务，不经过第三方商业平台
- 覆盖广泛：OpenStreetMap 数据覆盖全球，尤其在欧美地区精度较高
- 轻量集成：仅需 curl 和 python3 环境，无复杂依赖
潜在缺点与局限性
| 维度 | 说明 |
|------|------|
| 实时性 | 无实时交通数据，预估时长基于道路等级和固定速度模型，与实际通行时间可能存在显著偏差 |
| 速率限制 | Nominatim 严格限制 1 请求/秒；OSRM 公共服务器虽无硬性限流，但过度使用可能导致 IP 被封 |
| 服务稳定性 | 依赖免费公共服务，无 SLA 保障，高峰期可能出现延迟或不可用 |
| 交通模式 | 不支持公共交通（公交、地铁、铁路），仅覆盖道路网络 |
| 数据精度 | 偏远地区或新兴区域可能存在地址收录不全、道路数据滞后等问题 |
适合人群
- 开发者和运维人员需要快速集成地理功能而无需商业授权
- 隐私敏感用户希望避免 Google Maps、Baidu Maps 等平台的追踪
- 低频次使用的个人用户（如偶尔查询距离、规划徒步路线）
- 开源项目或教育场景演示地理信息系统基础原理
常规风险
1. 服务依赖风险：OSRM 和 Nominatim 均为无偿公共服务，生产环境关键业务不应直接依赖，建议自建服务或配置备选方案
2. 数据合规风险：Nominatim 要求遵守 OSM 使用政策（包括 User-Agent 标识），批量处理需额外注意
3. 精度预期管理：缺乏实时路况的时长预估在拥堵场景下误差可达 50%-200%，不适合时效敏感场景（如快递 ETA、紧急调度）
4. 坐标格式混淆：纬度在前、经度在后的 lat,lon 格式易与 GIS 常见的 lon,lat 混淆，需严格校验
5. 网络可达性：部分地区网络环境可能无法稳定访问 osm.org 相关域名