JustSERPDocs
Google

Google locations

Finds the exact place name to send as `location` to the Google endpoints: the `canonical_name` of a match is that name.

GET
/v1/google/locations

Finds the exact place name to send as location to the Google endpoints: the canonical_name of a match is that name. Covers every place Google can target (countries, regions, counties, cities, neighborhoods, postal codes, airports and more), with its coordinates and population where known.

Best matches come first: places whose name starts with q, then places whose name contains it, then places whose full name contains it, ignoring case and accents. Within each group, the largest reach first, then countries, regions, counties and cities ahead of smaller areas. No match is [].

Free: a call is never counted against your key's quota, though the key is checked and the call holds one of its concurrency slots. Answers may be cached for a day; the data is rebuilt about every two months. GET takes the same fields as query parameters.

Coordinates and population (reach) come from GeoNames, licensed under CC BY 4.0.

Authorization

headerX-API-Key<token>

Your API key.

Query Parameters

q*string
Length1 <= length <= 100
limit?integer
Range1 <= value <= 100
Default10

Response Body

The matches, best first. [] when nothing matches.

application/json
  1. response
[index: integer]?
Example Request
curl -X GET 'https://api.justserp.com/v1/google/locations?q=london&limit=10'
Example Response
[  {    "google_id": 1006886,    "google_parent_id": 20339,    "name": "London",    "canonical_name": "London,England,United Kingdom",    "target_type": "City",    "country_code": "GB",    "reach": 8961989,    "lat": 51.50853,    "lon": -0.12574  }]