Skip to content

Find places or addresses near a longitude/latitude pair

Endpoint

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

Parameters

Parameter Values Description Example
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
size Number The number of results returned 5
point.lat {latitude} (required) Latitude to focus search based on geographic area 10.734685744457877
point.lon {longitude} (required) Longitude to focus search based a geographical area 106.70378716390763
boundary.circle.radius Floating point number Distance radius (kilometer) 0.05
key String (required) API key public_key

Example code

https://maps.track-asia.com/api/v1/reverse?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?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