用途:该技能用于让 AI 代理与 Google Maps 数据交互,通过 Membrane CLI 调用 Google Maps 平台能力,涵盖导航、地点检索与位置服务等场景。
主要能力:提供多种预置动作,包括获取地点照片(get-place-photo)、生成静态地图(get-static-map)、计算距离矩阵(get-distance-matrix)、获取路线(get-directions)、地点自动补全(place-autocomplete)、地点详情(get-place-details)、附近地点搜索(search-nearby-places)、文本搜索地点(search-places)、海拔查询(get-elevation)、时区查询(get-timezone)、反向地理编码(reverse-geocode)和地址地理编码(geocode-address)。
使用方式:先安装 CLI:npm install -g @membranehq/cli@latest。登录:membrane login --tenant --clientName=<agentType>,无头环境会输出授权 URL,完成后执行 membrane login complete <code>。建立连接:membrane connection ensure "https://mapsplatform.google.com/" --json,若状态为 BUILDING 可用 npx @membranehq/cli connection get <id> --wait --json 轮询至 READY。查找动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。运行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json。也可通过代理直接请求:membrane request CONNECTION_ID /path/to/endpoint,支持 -X、-H、-d、--json、--query、--pathParam 等选项。
适用场景:需要路线规划、地点搜索、地理编码、距离与时间计算、静态地图生成等位置相关任务。
限制:认证与凭据刷新由 Membrane 自动处理,不应向用户索取 API 密钥或令牌;具体动作参数与返回结构需通过 action list 查询;官方文档见 https://developers.google.com/maps。