Geocoding

Reverse geocode — convert coordinates into the nearest address

Look up the nearest address, street, or place around a (lat, lon) pair. Results ordered by proximity. Results may be served from cache for up to 7 days, so repeated nearby lookups can return X-Cache: HIT.

get/v1/reverse

Request

  • Base URL: https://geo.thinair.co
  • URL: https://geo.thinair.co/v1/reverse
  • Auth: HTTP bearer

Query parameters

latnumber required

Latitude in decimal degrees, WGS84.

Example:30.2672
lonnumber required

Longitude in decimal degrees, WGS84.

Example:-97.7431
sizeinteger

Maximum candidates to return (1–40). Defaults to 5 in the service layer (capped to 40).

Example:5
layersstring

Restrict to a comma list of layers: address, street, venue, neighbourhood, borough, locality, localadmin, county, macrocounty, region, macroregion, dependency, country, continent, postalcode, or coarse (all admin layers). Admin layers resolve from the nearest indexed feature's parent hierarchy.

Example:address
boundary_countrystring

ISO 3166-1 alpha-2 or alpha-3 country code to scope results.

Example:US

Response

Reverse geocoder result envelope.

warningsstring[]

Geocoder warnings (geocoding.warnings) — present only when the suppress middleware emitted signals on this response.

upstream_errorstring nullable

Example response

{
  "features": [
    {
      "id": "ta_place_8f3a2c9e61c04d58"
    }
  ],
  "warnings": [
    "admin_fallback_suppressed"
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.