Skip to content

Find places or addresses near a longitude/latitude pair

Endpoint

https://maps.track-asia.com/api/v1/reverse

Parameters

Parameter Values Require Description Example
point.lat {latitude} ✔ Latitude to focus search based on geographic area 10.734685744457877
point.lon {longitude} ✔ Longitude to focus search based a geographical area 106.70378716390763
key String ✔ API key (use your own key; public_key is limited and for testing only) c public_key
lang Target language The target language code in the BCP47 standard. Only the language subtag information is used to set the target language e.g. en vi
boundary.circle.radius Floating point number Distance radius (kilometer) 0.05
new_admin true , false (default) Return address according to new administrative boundaries true
size Number The number of results returned 5

Example code

https://maps.track-asia.com/api/v1/reverse?new_admin=true&lang=vi&point.lon=106.70378716390763&point.lat=10.734685744457877&key=public_key

https://maps.track-asia.com/api/v1/reverse?lang=vi&point.lon=106.70378716390763&point.lat=10.734685744457877&size=5&boundary.circle.radius=0.05&key=public_key

curl -G "https://maps.track-asia.com/api/v1/reverse?new_admin=true&lang=vi&point.lon=106.70378716390763&point.lat=10.734685744457877&key=public_key"

const response = await fetch("https://maps.track-asia.com/api/v1/reverse?lang=vi&point.lon=106.70378716390763&point.lat=10.734685744457877&size=5&boundary.circle.radius=0.05&key=public_key")
const data = await response.json()
console.log(data)

Response

JSON Response

The response is a JSON object with the following structure:

  • type: "FeatureCollection". Indicates the type of GeoJSON object.
  • features: An array of Feature objects, each representing a found address or place. Each Feature has:
    • type: "Feature".
    • geometry: The geometry of the feature:
      • type: "Point".
      • coordinates: An array of [longitude, latitude] for the point.
    • properties: An object with details about the place:
      • id: Unique identifier for the feature.
      • gid: Global identifier for the feature.
      • layer: The layer type (e.g., "address", "venue").
      • name: Name of the place or address.
      • label: Formatted label for the address.
      • confidence: Confidence score for the result.
      • country, country_code, country_a, country_id: Country info.
      • region, region_a, region_id: Region info.
      • county, county_id: County info.
      • locality, locality_id: Locality info.
      • street: Street name (if available).
      • ...and other address-related fields as available.
  • bbox: An array [minLon, minLat, maxLon, maxLat] representing the bounding box of the results.

Next steps