Reverse Geocoding API

The Reverse Geocoding API enables you convert latitude/longitude coordinates to cities that fall within those coordinates. For regular geocoding, check out our geocoding API.

/v1/reversegeocoding GET

https://api.api-ninjas.com/v1/reversegeocoding

Returns a list of cities that contain a given latitude and longitude.


Parameters

  • lat  required

    Latitude coordinate.

  • lon  required

    Longitude coordinate.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Sample Request Live Demo!

lat
lon
https://api.api-ninjas.com/v1/reversegeocoding?lat=51.509865&lon=-0.118092

Sample Response

JSON
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 [ { "country": "GB", "name": "London" }, { "country": "GB", "name": "City of Westminster" }, { "country": "GB", "name": "Lambeth" }, { "country": "GB", "name": "Clerkenwell" }, { "country": "GB", "name": "City of London" } ]

Code Examples

1 2 3 4 5 6 7 8 9 10 11 import requests lat = 51.509865 lon = -0.118092 api_url = 'https://api.api-ninjas.com/v1/reversegeocoding?lat={}&lon={}'.format(lat, lon) response = requests.get(api_url, headers={'X-Api-Key': 'YOUR_API_KEY'}) if response.status_code == requests.codes.ok: print(response.text) else: print("Error:", response.status_code, response.text)

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.