Reverse Geocoding

Find places or addresses near a location

Description

Reverse geocoding is used for finding places or addresses near a latitude, longitude pair—like clicking on a map to see what's there when the map doesn't show it otherwise. For example, picture a map showing building outlines but no labels, then clicking on a building and being shown the name of the business. That's reverse geocoding.

Base URL

The base URL for all API requests is:

https://mapapis.ndamaps.vn/v1

Endpoint

GET /geocode/reverse

Google format

API references

Parameter	Type	Required	Default	Example
latlng	string	yes	none	21.03431,105.78823
admin_v2	boolean	no	false	Return information about new locations after administrative boundary consolidation

Example

Request:

GET /geocode/reverse?latlng=21.075951,105.812662&apikey=YOUR_API_KEY

Response

{
  "results": [
    {
      "address": "272 Đường Võ Chí Công, phường Phú Thượng, quận Tây Hồ, thành phố Hà Nội",
      "address_components": [
        {
          "long_name": "Lotte Mall Tây Hồ",
          "short_name": "Lotte Mall Tây Hồ"
        },
        {
          "long_name": "272 Đường Võ Chí Công",
          "short_name": "272 Đường Võ Chí Công"
        },
        {
          "long_name": "phường Phú Thượng",
          "short_name": "Phú Thượng"
        },
        {
          "long_name": "quận Tây Hồ",
          "short_name": "Tây Hồ"
        },
        {
          "long_name": "thành phố Hà Nội",
          "short_name": "Hà Nội"
        }
      ],
      "formatted_address": "Lotte Mall Tây Hồ, 272 Đường Võ Chí Công, phường Phú Thượng, quận Tây Hồ, thành phố Hà Nội",
      "geometry": {
        "location": {
          "lat": 21.075951,
          "lng": 105.812662
        }
      },
      "name": "Lotte Mall Tây Hồ",
      "place_id": "aQA0KHmLGXVtbpFgpMqFfA0OjpRAAVFgTGaOYDTSgKXVbpiV-A6xZXkuPZgc",
      "types": ["business_center"]
    }
  ],
  "status": "OK"
}

OSM Format

API references

Parameter	Type	Required	Default	Example
point.lat	floating point number	yes	none	21.03431
point.lon	floating point number	yes	none	105.78823
boundary.circle.radius	floating point number in km	no	1	1
size	integer	no	1	1
admin_v2	boolean	no	false	Return information about new locations after administrative boundary consolidation

Example

Request:

GET /geocode/reverse?point.lat=21.075951&point.lon=105.812662&size=1&boundary.circle.radius=1

Response:

{
  "errors": null,
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "coordinates": [105.812662, 21.075951],
        "type": "Point"
      },
      "properties": {
        "name": "Lotte Mall Tây Hồ",
        "housenumber": null,
        "street": null,
        "short_address": "272 Đường Võ Chí Công",
        "postalcode": null,
        "label": "Lotte Mall Tây Hồ, 272 Đường Võ Chí Công, phường Phú Thượng, quận Tây Hồ, thành phố Hà Nội",
        "country": "Việt Nam",
        "country_code": "VN",
        "category": ["business_center"],
        "website": "https://lottemallwestlakehanoi.vn/",
        "opening_hours": [
          [
            [0, 9, 30],
            [0, 22, 0]
          ],
          [
            [1, 9, 30],
            [1, 22, 0]
          ],
          [
            [2, 9, 30],
            [2, 22, 0]
          ],
          [
            [3, 9, 30],
            [3, 22, 0]
          ],
          [
            [4, 9, 30],
            [4, 22, 0]
          ],
          [
            [5, 9, 30],
            [5, 22, 0]
          ],
          [
            [6, 9, 30],
            [6, 22, 0]
          ]
        ],
        "phone": "+842433338000",
        "region": "thành phố Hà Nội",
        "county": "quận Tây Hồ",
        "locality": "phường Phú Thượng",
        "distance": 0,
        "id": "aQA0KHmLGXVtbpFgpMqFfA0OjpRAAVFgTGaOYDTSgKXVbpiV-A6xZXkuPZgc",
        "continent": "Asia",
        "source": "ndamapvn"
      }
    }
  ],
  "bbox": [],
  "type": "FeatureCollection"
}