Endpoint: The /google/places/ API endpoint allows you to GET the results of your Google Maps query and Google Search query.

📘

Google Maps or Google Search page?

If the location parameter is set to a latitude, longitude and zoom value - for example location=lat:37.8391952,lon:-122.2988076,zoom:12.41 then results will be returned from a Google Maps page.

If the location parameter is set to a location name from the Locations API (or any other free-form location name text) - for example Paris,France then results will be returned from a Google Search page.

Authentication: API-KEY. Use your API-KEY for authentication.
Output format: json, csv

Results: Click "200" at the bottom of the page in the Responses block to see the JSON structure of a successful response. See more about the results here.

location for Google Maps

To request Google Maps results based on latitude and longitude coordinates, you need to format the location parameter as follows: location=lat:37.8391952,lon:-122.2988076,zoom:12.41

Here, 37.8391952 is your latitude, -122.2988076 is your longitude, and 12.41 is your zoom level.

Remember to use commas , to separate each section and colons : to separate name/value pairs.

Valid zoom values range from 3 (maximum zoom-out) to 21 (maximum zoom-in).

Google may return results outside the bounds of the zoom level in some cases. If you want to limit the results to the current zoom level only, use strict:true in the location parameter.
For example, lat:39.58467741051493,lon:-0.6752313712718961,zoom:15,strict:true.

Examples:

• To search for a location at latitude 40.7128 and longitude -74.0060 with a zoom level of 10, the location parameter would be formatted as follows: location=lat:40.7128,lon:-74.0060,zoom:10.
• To search for a location in Paris with a zoom level of 14, the location parameter would be formatted as follows: location=lat:48.8566,lon:2.3522,zoom:14.
• To search for a location in Tokyo with a zoom level of 18 and only return results within the current zoom level, the location parameter would be formatted as follows: location=lat:35.6762,lon:139.6503,zoom:18,strict:true.

Support

If you have any questions about authentication or API usage, please contact our support team at [email protected].