Google Maps

核心用法

Google Maps Places技能通过ClawLink托管凭证体系，将Google Maps Platform的核心能力引入OpenClaw对话环境。用户无需自行申请API密钥或配置Google Cloud项目，仅需完成三步安装流程（安装插件→配对账户→连接Google Maps），即可调用覆盖地点搜索、地理编码、路线规划、距离矩阵、时区查询、海拔数据、道路吸附及静态地图生成等20余项工具。

典型工作流包括：使用googlemaps_search_places或googlemaps_nearby_search发现地点，通过googlemaps_place_details获取详情，利用googlemaps_geocode进行地址与坐标互转，以及调用googlemaps_directions或googlemaps_distance_matrix规划行程。所有工具调用均由ClawLink自动注入凭证，实现零配置使用。

显著优点

• 零凭证管理成本：ClawLink托管OAuth流程与API密钥，消除密钥泄露风险与轮换维护负担
• 覆盖场景全面：整合Places、Directions、Geocoding、Roads、Timezone、Elevation、Static Maps等7大API能力
• 实时数据支持：路线与导航结果可利用实时交通数据（如可用）
• 读操作为主的安全设计：绝大多数工具为只读操作，天然降低误操作风险
• 结构化工作流：提供clawlink_describe_tool和clawlink_preview_tool等辅助工具，支持调用前参数验证与效果预览

潜在缺点与局限性

• 代理层依赖：所有请求需经ClawLink中转，存在额外的网络延迟与单点故障风险
• 配额透明性不足：API调用受Google Cloud配额限制，但用户无法直接查看实时用量与剩余额度
• Place ID时效性：地点ID虽相对稳定，但仍可能随Google数据更新而变化，需从搜索响应中动态获取
• Roads API附加限制：snap_to_roads等工具需单独启用Roads API项目，非默认开通
• 地理覆盖与政策限制：部分国家/地区可能受Google服务可用性限制

适合人群

• 需要快速集成地理位置能力的OpenClaw用户，不愿投入Google Cloud配置与密钥管理成本
• 旅行规划、本地服务发现、物流路径优化等场景的应用构建者
• 对数据隐私敏感、希望避免直接暴露API密钥的个人开发者或小团队

常规风险

• 数据流转路径：位置查询数据需经ClawLink服务器代理，存在第三方数据可见性
• 服务连续性：ClawLink或Google Maps API的服务中断将直接影响可用性
• 误操作风险：虽写操作需显式确认，但批量距离矩阵查询等高消耗读操作仍可能在无意间耗尽配额
• 凭证锁定效应：深度使用后若需迁移至自主托管模式，可能面临数据与配置迁移成本

核心用法

google-maps-places 是一款集成 Google Maps Platform 全能力的智能技能，通过 ClawLink 托管代理实现零配置接入。用户无需自行申请 Google Cloud 账号或管理 API 密钥，仅需三步完成 ClawLink 配对即可调用全部地图服务。

该技能覆盖四大核心场景：地点搜索与发现（支持文本搜索、附近搜索、自动补全、详情查询）、地理编码服务（地址转坐标、反向地理编码）、路线与导航（多模式方向规划、距离矩阵、路程时间计算）、高级地理数据（海拔查询、时区获取、道路吸附、静态地图生成）。所有工具均通过 clawlink_call_tool 统一调用，参数遵循 Google Maps API 标准格式。

显著优点

零门槛接入是最大的差异化优势。传统 Google Maps API 需要开发者注册 GCP 项目、配置结算账户、管理密钥安全，而该技能通过 ClawLink 的 OAuth 托管机制完全屏蔽这些复杂度。其次，功能完整性突出，涵盖 Places、Directions、Geocoding、Elevation、Time Zone、Roads 六大 API 类别，共计 15+ 个工具。第三，安全架构清晰：凭证由 ClawLink 代理注入，技能本身无密钥存储；所有操作标记为 Read/Write 模式，写入操作强制用户确认；网络流量仅流向 Google 官方端点和 ClawLink 可信代理。

潜在缺点与局限性

作为纯文档型技能，其运行时依赖 ClawLink 插件，若 ClawLink 服务异常或用户未完成配对流程，功能将完全不可用。其次，API 配额与成本仍受 Google Cloud 计费策略约束，虽然用户无需直接管理，但高频调用可能触发用量限制。第三，地域覆盖限制：Google Maps 在中国大陆等地区的服务可用性受限，部分功能可能返回不完整数据。此外，Place ID 存在数据时效性问题，官方建议定期刷新而非持久化存储。

适合的目标群体

该技能特别适合三类用户：开发者与工程师需要快速集成地理服务而无需基础设施投入；商务与运营人员进行门店选址分析、配送路线优化、客户地址标准化；内容创作者与研究者获取地理数据可视化素材。对隐私敏感的企业用户而言，ClawLink 的凭证托管模式也比自管密钥更符合安全审计要求。

使用风险

性能风险：代理层引入额外网络跳数，极端情况下延迟高于直连 Google API。供应商锁定：深度依赖 ClawLink 生态，迁移需重新设计认证流程。数据隐私：位置查询经 ClawLink 代理转发，需审查其数据处理条款。可用性风险：Google Maps API 政策变更或 ClawLink 服务调整可能导致功能中断。建议生产环境用户监控 OVER_QUERY_LIMIT 等错误码并实施重试策略。