Search Google Maps

Inputs

• mnumber, optional

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

• qstring, optional

  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.

• znumber, optional

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

• glstring, optional

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

• hlstring, optional

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

• llstring, optional

  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.

• latnumber, optional

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

• lonnumber, optional

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

• datastring, optional

  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.

• typestring: search, place, optional

  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.

• startinteger, optional

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

• nearbyboolean, optional

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

• timeoutnumber, optional

  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.

• data_cidstring, optional

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

• locationstring, optional

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

• place_idstring, optional

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

• max_priceinteger, optional

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

• min_priceinteger, optional

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

• min_ratingnumber, optional

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

• open_statestring: now, 24h, optional

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

• open_on_daystring: mon, tue, wed, thu, fri, sat, sun, optional

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

• open_at_hourinteger, optional

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

• google_domainstring, optional

  Google domain used for the request.