API Parameters(Google Maps)
Parameters | Required | Desc |
---|---|---|
q | false | Parameter defines the query you want to search. You can use anything that you would use in a regular Google Maps search. The parameter is only required if type is set to search. |
ll | false | Parameter defines the GPS coordinates of the location where you want the search to originate from. Its value must match the following format:@ + latitude + , + longitude + , + zoom. This will form a string that looks like this:e.g. @40.7455096,-74.0083012,14z. The zoom attribute ranges from 3z, map completely zoomed out - to 21z, map completely zoomed in. The parameter should only be used when type is set to search. Results are not guaranteed to be within the requested geographic location. |
google_domain | false | Parameter defines the Google domain to use. It defaults to google.com. |
hl | false | Parameter defines the language to use for the Google Maps search. It's a two-letter language code. (e.g., en for English, es for Spanish, or fr for French). It defaults to en. |
gl | false | Parameter defines the country to use for the Google Maps search. It's a two-letter country code. (e.g., us for the United States, uk for United Kingdom, or fr for France). It defaults to us. |
data | false | Parameters can be used to filter search results. You can visit the Google Maps website, set the desired filters, and then simply copy the data values from its URL. One of the uses of the parameter is to search for a specific place; therefore, it is required if the type is set to place. Alternatively, place_id can be used. To use the data parameter to search for a specific place, it needs to be constructed in the following sequence:!4m5!3m4!1s + data_id + !8m2!3d + latitude + !4d + longitude. This will form a string that looks like this:!4m5!3m4!1s0x89c259b7abdd4769:0xc385876db174521a!8m2!3d40.750231!4d-74.004019. |
place_id | false | Parameter defines the unique reference to a place on a Google Map. Place IDs are available for most locations, including businesses, landmarks, parks, and intersections. place_id can be used without any other optional parameter. |
type | true | Parameter defines the type of search you want to make. It can be set to:search - returns a list of results for the set q parameter,place - returns results for a specific place when data parameter is set. Parameter is not required when using place_id. |
start | false | Parameter defines the result offset. It skips the given number of results. It's used for pagination. (e.g., 0 (default) is the first page of results, 20 is the 2nd page of results, 40 is the 3rd page of results, etc.). We recommend starting with 0 and increasing by 20 for the next page. There is no hard limit on the maximum offset number, but we recommend a maximum of 100 (page six) which is the same behavior as with the Google Maps web app. More than that, the result might be duplicated or irrelevant. |
engine | true | Set parameter to google_maps to use the Google Maps API engine. |
Modified at 2025-03-18 02:07:33