核心用法
Google Maps 技能是 OpenClaw 平台集成的专业地理信息服务，基于 Google 最新的 Routes API 构建，提供六大核心功能模块：
1. 距离与通行时间计算 (distance) — 支持实时路况预测，可指定出发/到达时间，提供悲观/乐观/最佳估计三种交通模型
2. 逐向导航路线 (directions) — 生成完整 turn-by-turn 指引，支持多路线备选、途经点优化（TSP 旅行商问题求解）
3. 距离矩阵批量计算 (matrix) — 高效计算多起点到多终点的距离与时间矩阵，适用于物流配送路径优化
4. 地理编码双向转换 (geocode/reverse) — 地址解析为坐标，或坐标反查地址
5. 地点搜索与详情 (search/details) — 基于关键词的 POI 搜索及详细信息获取
6. 公共交通规划 — 支持地铁/公交等 Transit 模式，可设定目标到达时间
配置要求：需设置 GOOGLE_API_KEY 环境变量，并在 Google Cloud Console 启用 Routes API、Places API、Geocoding API。
显著优点
- 数据权威性：直接调用 Google Maps 官方 Routes API，覆盖全球 200+ 国家/地区，地址解析精度业界领先
- 实时路况建模：独有的
traffic参数支持悲观/乐观/最佳估计三种模型，适合商务出行的时间冗余规划 - 多语言原生支持：内置希伯来语、日语、阿拉伯语等非拉丁语系地址解析，通过
GOOGLE_MAPS_LANG环境变量或--lang参数灵活切换 - 路线优化算法：
--optimize标志启用 TSP 求解，自动优化多途经点顺序，降低物流配送成本 - 灵活的时间控制：支持相对时间（
+1h）、绝对时间、未来出发预测及公交到达时间反向推算
潜在缺点与局限性
| 限制类型 | 说明 |
|---------|------|
| API 成本 | Google Maps API 为付费服务，高频调用可能产生显著费用，需配置用量配额与告警 |
| 区域功能差异 | `--fuel-efficient` 节油路线仅限美国/欧盟等部分国家；`--shorter` 短距离优化、两轮车模式 (`two_wheeler`) 在亚洲以外可用性有限 |
| 数据时效性 | 实时路况依赖 Google 数据采集，偏远地区或新建道路可能存在延迟 |
| 隐私合规 | 位置数据处理需符合 GDPR 等法规，日志中可能留存敏感地理信息 |
| 依赖外部服务 | 网络中断或 Google 服务异常将直接导致功能失效，无离线降级方案 |
适合人群
- 物流与配送企业：批量计算距离矩阵、优化多站点配送路径
- 商务出行规划者：需要预留时间冗余的重要会议行程安排
- 跨国业务运营：需处理多语言地址、覆盖全球主要市场的位置服务需求
- 开发者与数据分析师：需要结构化地理数据进行下游分析或可视化
常规风险
- API 密钥泄露风险：
GOOGLE_API_KEY为敏感凭证，若误提交至代码仓库或未限制 HTTP Referer，可能导致恶意调用与费用损失 - 成本失控风险：未设置用量上限时，矩阵计算等批量操作可能在短时间内产生高额账单
- 数据精度误差：地址模糊匹配可能返回错误坐标，关键业务场景需人工复核验证
- 服务可用性风险：Google API 服务等级协议 (SLA) 为 99.9%，极端场景下存在中断可能