Reverse geocode to clean admin hierarchy API

Turn a lat/lon into a normalized administrative hierarchy (country, state, county, city, suburb, street, house number, postcode) plus a single formatted address, by collapsing OpenStreetMap Nominatim's messy address fields into one predictable schema. Answers 'what address is at these coordinates', 'reverse geocode this lat/lon', 'what city/country is this point in', 'street address for a GPS fix'.

Price$0.01per request

MethodPOST

Route/v1/maps/reverse-geocode

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache3600s public

mapsreverse-geocodegeocodingnominatimosmaddresslatlonlocation

API URLhttps://x402.hexl.dev/v1/maps/reverse-geocode

Integration docs

Example request

{
  "latitude": 48.8584,
  "longitude": 2.2945
}

Example response

{
  "latitude": 48.8584,
  "longitude": 2.2945,
  "formatted": "Madame Brasserie, 5, Avenue Anatole France, Quartier du Gros-Caillou, Paris 7e Arrondissement, Paris, Île-de-France, 75007, France",
  "name": "Madame Brasserie",
  "placeType": "fast_food",
  "address": {
    "country": "France",
    "countryCode": "FR",
    "state": "Île-de-France",
    "stateCode": "FR-IDF",
    "county": "Paris",
    "city": "Paris",
    "suburb": "Quartier du Gros-Caillou",
    "street": "Avenue Anatole France",
    "houseNumber": "5",
    "postcode": "75007"
  }
}

Input schema

{
  "type": "object",
  "required": [
    "latitude",
    "longitude"
  ],
  "properties": {
    "latitude": {
      "type": "number",
      "examples": [
        48.8584
      ]
    },
    "longitude": {
      "type": "number",
      "examples": [
        2.2945
      ]
    },
    "zoom": {
      "type": "number",
      "examples": [
        18
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}