核心功能
Google Maps技能是OpenClaw平台上功能完整的地理位置服务集成,封装了Google Maps Platform的核心能力。主要提供三大工具链:
1. 地点搜索(search):支持自然语言查询(如"tel aviv coffee shop"),可叠加--open过滤营业中场所,返回评分、价格等级、地理位置等结构化数据
2. 详情查询(details):通过place_id获取深度信息,包括用户评论、完整营业时间、联系电话、照片URL等
3. 路线计算(distance):支持驾驶/步行/骑行三种模式的距离、预计耗时及实时路况估算
显著优势
- 数据源权威性:直接调用Google Places API、Distance Matrix API和Geocoding API,POI数据覆盖全球2亿+地点
- 实时性:营业时间状态、路况数据均为实时更新
- 本地化支持:原生希伯来语/英语双语切换,适合中东及国际用户
- 工程封装:通过
map_helper.py统一接口,参数自动校验,降低直接调用API的复杂度
局限性
- 成本敏感:Google Maps API按调用量阶梯计费(Places API约$17/1000次),高频使用可能产生显著费用
- 环境依赖重:需预先配置3个独立API的启用状态及计费账户,新手配置门槛较高
- 功能边界:不提供路线导航的逐步语音指引(仅限距离/时间计算),无离线地图能力
- 地理限制:部分区域(如中国大陆)数据精度或可用性受限
适用场景
- 旅行规划中的餐厅/酒店筛选与对比
- 物流配送的路线距离批量估算
- 本地生活服务查询(结合营业时间过滤)
- 多地点之间的通勤时间矩阵分析
风险提示
- API密钥泄露风险:
GOOGLE_API_KEY需严格保管,硬编码提交可能导致恶意刷量及账单失控 - 计费失控风险:未设置用量上限时,循环调用或异常流量可能触发高额账单
- 隐私合规:用户位置数据需符合GDPR/本地法规,建议日志脱敏处理