核心功能
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 服务条款合规性