Geocoding (address ↔ coordinates) API

Forward geocode an address/place to coordinates, or reverse geocode coordinates to an address (OpenStreetMap Nominatim). Answers 'coordinates for this address', 'what's at this lat/lng', 'geocode this place'.

Price$0.01per request

MethodPOST

Route/v1/data/geocode

StatusLive

MIME typeapplication/json

Rate limit30/minute

Cache86400s public

datageocodegeocodingaddresscoordinatesnominatimosmlocation

API URLhttps://x402.hexl.dev/v1/data/geocode

Integration docs

Example request

{
  "op": "forward",
  "query": "Eiffel Tower"
}

Example response

{
  "op": "forward",
  "query": "Eiffel Tower",
  "results": [
    {
      "displayName": "Tour Eiffel, Paris, France",
      "latitude": 48.8584,
      "longitude": 2.2945,
      "address": {
        "city": "Paris",
        "country": "France"
      }
    }
  ]
}

Input schema

{
  "type": "object",
  "properties": {
    "op": {
      "type": "string",
      "enum": [
        "forward",
        "reverse"
      ]
    },
    "query": {
      "type": "string"
    },
    "latitude": {
      "type": "number"
    },
    "longitude": {
      "type": "number"
    },
    "limit": {
      "type": "number",
      "default": 5
    }
  }
}

Output schema

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