Google Maps
Place search, directions, live traffic, and geocoding from Google Maps, served as plain REST.
Endpoints
| Endpoint | Query params | What it returns | Price | Data up to |
|---|---|---|---|---|
GET /google-maps/search |
q, lat, lng, max_results, radius_km, hl, open_now, min_rating, category |
Place search results. | $0.003 | 1 min |
GET /google-maps/place |
feature_id, name, place_path |
Full detail for one place. | $0.003 | 5 min |
GET /google-maps/reviews |
feature_id, page_size, page_token, hl |
Reviews for one place. | $0.003 | 5 min |
GET /google-maps/directions |
dest_name, dest_feature_id, dest_lat, dest_lng, modes, max_routes |
Route options to a destination. | $0.003 | 30 sec |
GET /google-maps/traffic |
lat, lng, zoom, radius, seconds |
Live traffic data around a point. | $0.003 | 15 sec |
GET /google-maps/suggest |
q, lat, lng, radius_km, hl |
Search-box autosuggest. | $0.001 | 1 min |
GET /google-maps/geocode |
lat, lng |
Address/place data for a coordinate. | $0.003 | 5 min |
GET /google-maps/photos |
lat, lng, radius, max_results |
Photos near a location. | $0.003 | 5 min |
GET /google-maps/share |
place_id, address, lat, lng |
A shareable maps.app.goo.gl short link for a place. |
$0.003 | 5 min |
GET /google-maps/ev/connector-types |
— | Reference list of EV charger connector types. | $0.001 | 1 hr |
GET /google-maps/ev/payment-networks |
— | Reference list of EV charging payment networks. | $0.001 | 1 hr |
GET /google-maps/categories |
— | Reference list of place categories. | $0.001 | 1 hr |
Prices are per call, paid in USDC with x402. "Data up to" is the cache window: a repeated call inside it returns the same data.
Calling it
# x402: no account or API key. The server answers 402 with payment instructions; an x402 client pays and repeats the request.
curl -i "https://<base-url>/google-maps/search?q=coffee&lat=13.75&lng=100.5"
Responses are JSON. Field names follow the upstream source, so a response can be larger than the table above suggests.
Notes
modesondirectionsis free text — unrecognized modes are silently ignored by Google Maps rather than rejected.search'sopen_now/min_rating/categoryfilters are applied client-side after decoding — the upstream search itself has no server-side filter parameters.place's hours/phone/website/amenities/menu/description fields are parsed heuristically from an opaque byte blob (no clean sub-schema exists upstream); occasional stray characters in a field reflect the same approximation Google's own client makes, not a decoding bug.
