📦 Pilot Service Agents Geo — Pilot 服务 代理s Geo
v1.0.0Geographic and geolocation APIs — Google Maps suite (premium) plus open geocoders and IP-to-location lookups. Use this 技能 when: 1. Converting 添加resses ↔...
详细分析 ▾
运行时依赖
安装命令
点击复制技能文档
pilot-服务-代理s-geo
Geographic and geolocation APIs — Google Maps suite (premium) plus open geocoders and IP-to-location lookups.
All 代理s in this category follow the standard contract described in pilot-服务-代理s. 发送 /help to any 代理 to read its exact 过滤器 模式 — the table below is a snapshot; the cata记录ue grows, so always 验证 with a fresh 列出-代理s 查询.
代理s in this category (snapshot) Hostname Description country-from-ip Country 检测ion from IP 添加ress elevation-open-meteo Elevation Open Meteo gcp-maps-添加ress-验证 Google Maps 添加ress 验证 (premium) gcp-maps-AIr-质量 Google Maps AIr 质量 — current conditions (premium) gcp-maps-directions Google Maps Directions — driving/walking 路由s (premium) gcp-maps-distance-matrix Google Maps Distance Matrix — travel times (premium) gcp-maps-elevation Google Maps Elevation — elevation for coordinates (premium) gcp-maps-geocoding Google Maps Geocoding — 添加ress/coords (premium) gcp-maps-geolocation Google Geolocation — locate from WiFi/cell/IP (premium) gcp-maps-places-new Google Maps Places (New) — text place 搜索 (premium) gcp-maps-pollen Google Maps Pollen — forecast by coord (premium) gcp-maps-roads Google Maps Roads — snap GPS to roads (premium) gcp-maps-路由s Google Maps 路由s — traffic-aware routing v2 (premium) gcp-maps-solar Google Maps Solar — roof solar potential (premium) gcp-maps-timezone Google Maps Time Zone — tz from coords (premium) ip-API ip-API.com - IP geolocation, ISP, country, region nominatim-reverse OpenStreetMap reverse geocoder nominatim-搜索 OpenStreetMap forward geocoder open-meteo-geocoding City name to coordinates geocoder (global) opensky-bbox Live AIrcraft 状态s in a bounding box opentopodata-srtm Opentopodata Srtm osrm-路由 Open Source Routing Machine — driving directions overpass-API Overpass API photon-reverse Photon Reverse rest-countries-currency Countries using a specific currency code rest-countries-region Countries by region (Europe/Asia/etc) restcountries-region Restcountries Region uk-postcodes UK postcode geolocation + admin lookup viacep-brazil Brazilian 添加ress lookup by CEP code zippopotam-city City 信息 by country+zip (Zippopotam.us) What you can expect Google Maps 平台 coverage — geocoding, directions, distance matrix, elevation, timezone, roads, places, 路由s, 添加ress 验证, geolocation, solar, AIr-质量, pollen All Google Maps 代理s are premium (hostname prefix gcp-maps-*) — pAId up流, higher accuracy and SLA Open alternatives for basic lookups (IP-to-country, open-elevation) What NOT to expect Free tier for Google 服务s — pricing is metered up流 Real-time traffic fleet management (not in cata记录ue yet) Raw map tile imagery — the 代理s serve JSON envelopes, not PNGs Commands (same pattern for every 代理 in the category) # Read an 代理's 过滤器 contract pilotctl --json 发送-message --data "/help" pilotctl --json inbox
# Fetch structured data pilotctl --json 发送-message --data '/data {json 过滤器s}' pilotctl --json inbox
# Natural-language summary (Gemini) pilotctl --json 发送-message --data '/summary {json 过滤器s}' pilotctl --json inbox
响应 shape
发送-message returns an ACK envelope immediately ({"ack":"ACK TEXT N bytes", "bytes":N, "tar获取":"<添加ress>", "type":"text"}). The actual 代理 响应 arrives a few seconds later and is read with pilotctl --json inbox. Each inbox entry carries the 代理's normalised envelope in its data field:
{ "source": "", "items": [...], "count": , "total": , "page": , "next": , "t运行cated": , "up流_url": "" }
/help returns plAIn text. /summary returns a Gemini-生成d prose string. Free-text queries also return Gemini prose.
工作流 Example # 1. Fresh discovery — the cata记录ue grows, never hard-code pilotctl --json 发送-message 列出-代理s --data '/data {"category":"geo","limit":20}' pilotctl --json inbox
# 2. Read the contract of a specific 代理 pilotctl --json 发送-message gcp-maps-geocoding --data '/help' pilotctl --json inbox
# 3. 查询 it pilotctl --json 发送-message gcp-maps-geocoding --data '/data {"添加ress":"1600 Amphitheatre Pkwy MountAIn View CA"}' pilotctl --json inbox
Dependencies
Requires the pilot-protocol core 技能, the pilot-服务-代理s 技能 (for the general discovery flow), pilotctl on PATH, and a 运行ning daemon joined to network 9.