Forward Geocoding APIs

Chuyển đổi địa chỉ hoặc tên địa điểm thành tọa độ kinh độ và vĩ độ.

Mô tả

API Forward Geocoding (Chuyển đổi địa chỉ) sẽ tìm các tọa độ kinh độ và vĩ độ dựa trên địa chỉ hoặc tên địa điểm—Như khi bạn nhập một địa chỉ vào thanh tìm kiếm để xem vị trí của nó trên bản đồ.

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

https://mapapis.openmap.vn/v1

Endpoint

GET /geocode/forward

Định dạng Google

Tham chiếu API

Tham số	Loại	Bắt buộc	Mặc định	Ví dụ
address	string	có	không	phuong mai dich
admin_v2	boolean	không	false	Trả về thông tin địa điểm mới sau sáp nhập địa giới hành chính

Ví dụ

Yêu cầu:

GET /geocode/forward?address=12 Ngõ 1 Dịch Vọng Hậu, Dịch Vọng Hậu, Cầu Giấy, Hà Nội&apikey=YOUR_API_KEY

Trả về:

{
  "results": [
    {
      "address": "phường Dịch Vọng Hậu, quận Cầu Giấy, thành phố Hà Nội",
      "address_components": [
        {
          "long_name": "12 Ngõ 1 Phố Dịch Vọng Hậu",
          "short_name": "12 Ngõ 1 Phố Dịch Vọng Hậu"
        },
        {
          "long_name": "phường Dịch Vọng Hậu",
          "short_name": "Dịch Vọng Hậu"
        },
        {
          "long_name": "quận Cầu Giấy",
          "short_name": "Cầu Giấy"
        },
        {
          "long_name": "thành phố Hà Nội",
          "short_name": "Hà Nội"
        }
      ],
      "formatted_address": "12 Ngõ 1 Phố Dịch Vọng Hậu, phường Dịch Vọng Hậu, quận Cầu Giấy, thành phố Hà Nội",
      "geometry": {
        "location": {
          "lat": 21.032783,
          "lng": 105.787915
        }
      },
      "name": "12 Ngõ 1 Phố Dịch Vọng Hậu",
      "place_id": "IbRaWQQeWAktoVyLNm16X6HCFG1o3lF9mXJwfXTCneX1UnE9aM_1YWy2mGm0",
      "types": [""]
    }
  ],
  "status": "OK"
}

Định dạng OSM

Tham chiếu API

Tham số	Loại	Bắt buộc	Mặc định	Ví dụ
text	string	có	không	phuong mai dich
size	integer	không	1	1
admin_v2	boolean	không	false	Trả về thông tin địa điểm mới sau sáp nhập địa giới hành chính

Ví dụ

Yêu cầu:

GET /geocode/forward?text=12 Ngõ 1 Dịch Vọng Hậu, Dịch Vọng Hậu, Cầu Giấy, Hà Nội&apikey=YOUR_API_KEY

Trả về:

{
  "bbox": [],
  "errors": null,
  "features": [
    {
      "geometry": {
        "coordinates": [105.787915, 21.032783],
        "type": "Point"
      },
      "properties": {
        "category": [""],
        "continent": "Asia",
        "country": "Việt Nam",
        "country_code": "VN",
        "county": "quận Cầu Giấy",
        "distance": null,
        "housenumber": "",
        "id": "IbRaWQQeWAktoVyLNm16X6HCFG1o3lF9mXJwfXTCneX1UnE9aM_1YWy2mGm0",
        "label": "12 Ngõ 1 Phố Dịch Vọng Hậu, phường Dịch Vọng Hậu, quận Cầu Giấy, thành phố Hà Nội",
        "locality": "phường Dịch Vọng Hậu",
        "name": "12 Ngõ 1 Phố Dịch Vọng Hậu",
        "opening_hours": null,
        "opening_hours_v2": null,
        "phone": null,
        "postalcode": null,
        "region": "thành phố Hà Nội",
        "short_address": "",
        "source": "openmapvn",
        "street": "",
        "website": null
      },
      "type": "Feature"
    }
  ],
  "type": "FeatureCollection"
}