Country / region at a coordinate (offline) API

Resolve a lat/lon to its country name, ISO alpha-2/alpha-3 code, continent, and UN region/subregion via offline ray-casting point-in-polygon over a cached Natural Earth boundary snapshot — no per-request network call. Answers 'what country is this point in', 'which country owns these coordinates', 'ISO code for a lat/lon', 'is this point on land or in the ocean'.

Price$0.01per request

MethodPOST

Route/v1/maps/country-at

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache86400s public

mapscountry-atpoint-in-polygonboundariesisogeofencereverse-countryoffline

API URLhttps://x402.hexl.dev/v1/maps/country-at

Integration docs

Example request

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

Example response

{
  "latitude": 48.8584,
  "longitude": 2.2945,
  "found": true,
  "country": "France",
  "countryLong": "France",
  "countryCode": "FR",
  "countryCode3": "FRA",
  "continent": "Europe",
  "region": "Europe",
  "subregion": "Western Europe"
}

Input schema

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

Output schema

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