谷歌地图助手

要解决什么问题

在 Agent 或自动化流程里，「把地址变成坐标」「查附近餐厅」「算 A 到 B 怎么走、要多久」「一批起点到一批终点的距离矩阵」这类需求，如果每次都手写 HTTP 调用 Google Maps API、维护 OAuth 与字段 mask，成本和出错面都很大。本技能把能力收敛到 Rube MCP（Composio） 暴露的一组工具上，让模型按固定工作流调用，而不是临时拼 REST。

核心能力与用法

前提很简单：客户端已接入 Rube MCP，且通过 RUBE_MANAGE_CONNECTIONS 把 google_maps 工具包连到 ACTIVE；每次跑业务前先用 RUBE_SEARCH_TOOLS 拉当前 schema，避免参数名漂移。

典型能力包括：

• 地理编码 / 逆地理编码：GOOGLE_MAPS_GEOCODING_API 把街道地址转成经纬度；GOOGLE_MAPS_GEOCODE_LOCATION 把坐标转回可读地址（入参必须是 lat/lng，不能误传地址字符串）。
• 地点发现：GOOGLE_MAPS_TEXT_SEARCH 自由文本搜点；GOOGLE_MAPS_NEARBY_SEARCH 在圆域内按类型搜（例如用 restaurant、cafe，不要用无效的 food）。
• 路线与批量距离：GOOGLE_MAPS_GET_ROUTE 算单条路线；多对多场景用 GOOGLE_MAPS_COMPUTE_ROUTE_MATRIX，结果在 data.elements 里按 originIndex / destinationIndex 索引，而不是 routes[]。
• 详情与体验：先用搜索拿 place id，再调 GOOGLE_MAPS_GET_PLACE_DETAILS 补营业时间、联系方式等；输入联想可用 GOOGLE_MAPS_AUTOCOMPLETE；页面嵌入用 GOOGLE_MAPS_MAPS_EMBED_API（仅 API Key，不走 OAuth2）。

常见组合：先 geocode 再 route；先 text search 再 place details。

边界与注意点

• GOOGLE_MAPS_GET_ROUTE 返回的时长常为 "937s" 这类字符串，数值比较前需自行解析。
• travelMode 为 WALK / BICYCLE / TRANSIT 时不能设置 routingPreference，应省略该参数。
• 工具包文档见 Composio Google Maps toolkit；连接未 ACTIVE 时按 MCP 返回的授权链接完成绑定后再跑流程。