Maps
Discover businesses and places with structured Google Maps results, location filters, and per-page billing.
Each completed request costs 3 credits and fetches one page of up to 20 places, including a confirmed empty page. Technical failures are not charged. Use the same query and location with the next page number for another separately billed request; reducing max_results does not reduce the page charge.
The response contains searchParameters and results, following the single-request format of Search and News. searchParameters includes the requested page and normalized defaults. See Credits and limits for billing rules and how to check your remaining balance.
Authorization
bearerAuth In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Google Maps search phrase; leading and trailing whitespace is removed.
1 <= length <= 1000Two-letter country code, normalized to lowercase. Defaults to us.
^[a-zA-Z]{2}$"us"Result language, for example en, de or zh-CN. Defaults to en.
^[a-z]{2,3}(-[a-zA-Z]{2,4})?$"en"Search origin coordinates and map zoom (default 14). Required for page > 1. Latitude must be -90 to 90, longitude -180 to 180, and zoom 3 to 30. Example: {"latitude":40.7455,"longitude":-74.0083,"zoom":15}.
Page number, 1–6; default 1. Accepts an integer or canonical integer string such as "2". Empty strings use the default. Pages after the first require location.
1 <= value <= 61Maximum places to return from this page, 1–20; default 20. Accepts an integer or canonical integer string such as "10". Empty strings use the default. Truncation does not reduce the page charge or carry places to the next page.
1 <= value <= 2020Response Body
application/json
application/json
application/json
application/problem+json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/maps" \ -H "Content-Type: application/json" \ -d '{ "query": "coffee in Manhattan" }'{ "searchParameters": { "query": "string", "country": "us", "language": "en", "location": { "latitude": -90, "longitude": -180, "zoom": 14 }, "page": 1, "max_results": 20 }, "results": [ { "position": 1, "name": "string", "place_id": "string", "maps_url": "http://example.com", "address": "string", "phone": "string", "website": "http://example.com", "thumbnail": "http://example.com", "category": "string", "categories": [ "string" ], "rating": 0, "review_count": 0, "coordinates": { "latitude": -90, "longitude": -180 }, "opening_hours": { "monday": "string", "tuesday": "string", "wednesday": "string", "thursday": "string", "friday": "string", "saturday": "string", "sunday": "string" }, "open_state": "string", "price": "string", "description": "string" } ]}{ "ok": false, "error": "string", "message": "string", "errors": [ { "field": "string", "message": "string", "code": "string" } ], "type": "http://example.com", "title": "string", "status": 0, "detail": "string"}{ "ok": false, "error": "string", "message": "string", "errors": [ { "field": "string", "message": "string", "code": "string" } ], "type": "http://example.com", "title": "string", "status": 0, "detail": "string"}{ "ok": false, "error": "string", "message": "string", "errors": [ { "field": "string", "message": "string", "code": "string" } ], "type": "http://example.com", "title": "string", "status": 0, "detail": "string"}{ "ok": false, "error": "string", "message": "string", "errors": [ { "field": "string", "message": "string", "code": "string" } ], "type": "http://example.com", "title": "string", "status": 0, "detail": "string"}{ "ok": false, "error": "string", "message": "string", "errors": [ { "field": "string", "message": "string", "code": "string" } ], "type": "http://example.com", "title": "string", "status": 0, "detail": "string"}{ "ok": false, "error": "string", "message": "string", "errors": [ { "field": "string", "message": "string", "code": "string" } ], "type": "http://example.com", "title": "string", "status": 0, "detail": "string"}{ "ok": false, "error": "string", "message": "string", "errors": [ { "field": "string", "message": "string", "code": "string" } ], "type": "http://example.com", "title": "string", "status": 0, "detail": "string"}{ "ok": false, "error": "string", "message": "string", "errors": [ { "field": "string", "message": "string", "code": "string" } ], "type": "http://example.com", "title": "string", "status": 0, "detail": "string"}