Google Maps

核心用法

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%，极端场景下存在中断可能

核心用法

Google Maps Skill 是 OpenClaw 平台的地图服务扩展，基于 Google 官方 Routes API、Places API 和 Geocoding API 构建。用户可通过命令行工具调用六项核心功能：

1. 距离与时间计算（distance）：计算两点间路程，支持未来出发时间预测、交通模型（乐观/悲观/最佳估计）、避障选项（收费/高速/轮渡）及多交通方式（驾车/步行/骑行/公交）。
2. 转向导航（directions）：生成详细路段指引，支持多路线备选、中途经停点优化（TSP 算法）。
3. 距离矩阵（matrix）：批量计算多起点到多终点的距离与时间，适用于物流调度场景。
4. 地理编码（geocode/reverse）：地址与坐标互转，支持全球任意语言地址。
5. 地点搜索（search/details）：基于文本搜索周边地点，获取营业时间、评分等详情。

配置需设置 GOOGLE_API_KEY 环境变量，支持多语言响应（GOOGLE_MAPS_LANG）。

显著优点

• 数据权威性：直接调用 Google Maps 官方 API，覆盖全球 200+ 国家/地区，实时交通数据更新频繁。
• 功能完整：涵盖个人出行（导航、公交规划）到企业应用（距离矩阵优化、批量 geocoding）。
• 智能预测：支持未来出发时间规划，结合历史与实时数据预估到达时间，交通模型可应对不同严谨程度需求。
• 多语言原生支持：地址输入支持希伯来语、日语、阿拉伯语等非拉丁字符，输出语言可配置。
• 安全架构：API 密钥通过环境变量注入，无硬编码风险，全链路 HTTPS 加密。

潜在缺点与局限性

• 区域功能差异：环保路线（--fuel-efficient）、两轮车模式（two_wheeler）等功能仅限特定国家，需查阅 Google 覆盖地图。
• 成本约束：Google Maps API 为付费服务，高频调用（如批量矩阵计算）可能产生显著费用，需配额管理。
• 网络依赖：所有功能均需实时联网，无离线缓存机制。
• 隐私合规：地理位置数据发送至 Google 服务器，敏感场景需额外数据保护协议。

适合人群

• 个人用户：规划通勤、旅行路线，估算出行时间。
• 物流/配送企业：优化多配送点路径、计算服务半径、预估到达时间窗口。
• 本地生活应用开发者：集成地点搜索、地址解析功能。
• 跨国团队：需要多语言地址处理与全球一致的位置服务。

常规风险

| 风险类型 | 说明 | 缓释措施 |

|---------|------|---------|

| API 密钥泄露 | 环境变量配置不当可能导致密钥暴露 | 使用密钥管理服务，限制 API Key 使用范围（IP/Referer 白名单） |

| 成本超支 | 高频调用或矩阵计算产生意外费用 | 设置 Google Cloud 配额限制，启用预算告警 |

| 服务可用性 | Google API 服务中断影响功能 | 实现降级逻辑，关键场景配置备用地图服务商 |

| 数据隐私 | 位置数据上传至 Google | 评估 GDPR/CCPA 合规要求，敏感位置数据脱敏处理 |