Google Maps

核心功能

Google Maps Skill 为 OpenClaw 提供了完整的地理位置服务能力，通过 Python 辅助脚本封装 Google Maps Platform API，支持三大核心动作：

• 搜索 (search): 地点模糊查询，支持 --open 筛选营业中商家
• 详情 (details): 基于 place_id 获取完整商户信息（评分、营业时间、电话、评论）
• 距离计算 (distance): 多模式路线规划（驾车/步行/骑行），返回实时距离与预估时间

显著优点

1. 数据权威性: 直接调用 Google Maps Platform，POI 数据覆盖全球，更新频率高
2. 实时性: 支持「营业中」筛选、实时交通模式距离计算
3. 双语本地化: 内置希伯来语/英语动态切换（--lang 参数）
4. 轻量封装: 通过 map_helper.py 统一接口，降低直接使用 REST API 的复杂度

潜在局限

| 方面 | 说明 |

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

| 成本门槛 | 需自行申请 Google Cloud API Key，高频调用产生计费 |

| 依赖外部 | 完全依赖 Google 服务可用性，国内网络环境可能受限 |

| 功能边界 | 未内置地理编码逆解析、静态地图生成等进阶能力 |

| 隐私合规 | 位置查询需遵循 Google 及本地数据保护法规 |

适用人群

• 需要快速验证地址、查询商户信息的业务场景
• 物流/配送类应用开发者（距离矩阵计算）
• 多语言客服系统（希伯来语优先支持）

常规风险提示

• API 密钥需妥善保管，避免硬编码泄露导致滥用扣费
• 建议配置 Google Cloud 用量配额与告警
• 商业使用需确认 Google Maps Platform 服务条款合规性

核心功能

该 Skill 是 Google Maps Platform 在 OpenClaw 环境中的轻量级封装，提供三类核心能力：

地点搜索（Search）：通过 search 指令查询地点，支持 "open" 参数筛选营业中商户，返回名称、地址、评分、坐标等结构化数据。

详情查询（Details）：基于 place_id 获取深度信息，包括营业时间、联系电话、用户评论、照片引用等。

路线规划（Distance）：计算两点间距离与预估时间，支持驾车、步行、骑行三种交通模式。

显著优点

1. 官方数据源：直接调用 Google Maps Platform API，数据实时性、覆盖范围与准确性有全球级保障
2. 多语言支持：内置希伯来语（默认）与英语切换，满足国际化需求
3. 轻量依赖：仅依赖 Python 标准库 + requests，无复杂供应链风险
4. 密钥管理规范：强制通过环境变量 GOOGLE_MAPS_API_KEY 注入，无硬编码风险

潜在局限

• 商业成本：Google Maps Platform 按调用量计费，高频使用可能产生费用
• 网络依赖：完全依赖外部 API，离线场景不可用
• T3来源风险：作者为个人开发者 shaharsh，无企业背书，长期维护承诺存疑
• 输入校验不足：当前版本对用户输入缺乏长度与字符过滤，存在潜在注入面

适合人群

• 需要快速集成地理位置服务的开发者
• 已拥有 Google Cloud 账户及 Maps API 配额的用户
• 对希伯来语/英语双语支持有需求的场景（如以色列本土业务）

常规风险

1. API密钥泄露：密钥通过 URL 参数传递，可能被服务器日志记录；建议启用 GCP 的 IP 白名单与配额监控
2. 成本失控：未设置用量上限可能导致账单激增
3. 隐私合规：地点查询数据经 Google 处理，需确保符合 GDPR/CCPA 等法规的告知义务