Reverse Geocoding APIs

Tìm kiếm địa điểm, địa chỉ gần một tọa độ.

Description

API Reverse Geocoding (Truy xuất địa điểm) sẽ tìm các địa chỉ, địa điểm gần một cặp tọa độ gồm kinh độ và vĩ độ—Như khi bạn nhấp vào một điểm trên bản đồ để xem tại điểm đó là địa điểm nào, địa chỉ là gì nhưng bản đồ không hiển thị. Ví dụ như, khi bản đồ hiển thị có một tòa nhà nhưng không có nhãn thể hiện tòa nhà đó, và sau khi nhấp vào tòa nhà này hệ thống hiển thị thông tin của tòa nhà thì đó chính là API Reverse Geocoding (Truy xuất địa điểm).

mẹo

Hãy sử dụng Enterprise Dashboard hoặc hướng dẫn API Key để tạo API Key và trải nghiệm miễn phí!

Base URL

Mã URL chung cho tất các yêu cầu API: https://mapapis.openmap.vn/v1

Endpoint

GET /geocode/reverse

Định dạng Google

Tham chiếu API

Tham số	Loại	Bắt buộc	Mặc định	Ví dụ
latlng	string	có	không	21.03431,105.78823

Ví dụ

Yêu cầu:

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

Trả về:

{
  "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"
}

Định dạng OSM

Tham chiếu API

Tham số	Loại	Bắt buộc	Mặc định	Ví dụ
point.lat	số thực	có	không	21.03431
point.lon	số thực	có	không	105.78823
boundary.circle.radius	số thực (đơn vị: km)	không	1	1
size	số nguyên	không	1	1

Ví dụ

Yêu cầu:

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

Trả về:

{
  "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": "openmapvn"
      }
    }
  ],
  "bbox": [],
  "type": "FeatureCollection"
}