Search Google Maps places

Search query, such as coffee shops in Austin, TX. Required when type=search. A search needs one of q, place_id, data_cid or data.

search returns a list of places in local_results; place returns one exact place in place_results. Required when searching by q or by filter data, and type=place is required with an exact-place data sequence. Can be omitted with place_id or data_cid.

Google Place ID for an exact-place lookup. Mutually exclusive with data_cid and an exact-place data sequence.

Decimal Google CID for an exact-place lookup. Mutually exclusive with place_id and an exact-place data sequence.

Google Maps protobuf sequence copied from a Maps URL, beginning with ! and at most 8,192 characters. A sequence that identifies one place requires type=place and is mutually exclusive with place_id and data_cid.

Map viewport as @latitude,longitude,zoomz or @latitude,longitude,radiusm, for example @30.2672,-97.7431,14z. Already includes its scale, so do not add z or m. Mutually exclusive with location and lat/lon.

Human-readable location to center the map on, such as Austin, Texas. Requires z or m. Mutually exclusive with ll and lat/lon.

Latitude of the map center. Supply with lon and either z or m. Mutually exclusive with ll and location.

Longitude of the map center. Supply with lat and either z or m. Mutually exclusive with ll and location.

Zoom level from 3 through 30. Use with location or lat/lon. Mutually exclusive with m.

Map radius in meters, from 1 through 15,028,132. Use with location or lat/lon. Mutually exclusive with z.

Set to true to remove near me wording from the query so the supplied viewport is used. Requires ll, location or lat/lon.

Language code such as en, en-GB, or de.

Two-letter country code used to localize results. Defaults to us.

Google domain used for the request.

Result offset in steps of 20: 0, 20, 40 and so on. Prefer following pagination.next from the previous response.

Minimum Google price level, a non-negative integer. Must not exceed max_price.

Maximum Google price level, a non-negative integer. Must be at least min_price.

Minimum star rating. Google treats it as a relevance preference, so lower-rated or unrated places may still appear.

now returns places open now; 24h returns places open 24 hours. Cannot be combined with open_on_day or open_at_hour.

Return places open on this weekday, optionally at open_at_hour. Cannot be combined with open_state.

Hour from 0 through 23 at which the place must be open. Requires open_on_day. Cannot be combined with open_state.

Optional budget for the entire request in seconds, measured from gateway receipt until the response is ready to send. Includes admission, queueing and settlement. Must be greater than 0 and at most 90. On expiry, the call is not billed and returns 503 request_deadline_exceeded with retryable=true and a request ID. Omit to retain the standard server deadline.