Maps APIs
eKMap PlatformMaps APIsNavigationNearest API

Nearest API

Nearest API tìm điểm gần nhất trên mạng lưới đường giao thông từ một vị trí địa lý bất kỳ.

Bạn có thể tham khảo ví dụ sử dụng Nearest API với JavaScript

URL

URL: /navigation/nearest/{profile}/driving/{coordinates}

Method

Method: GET

Parameters:

* tham số yêu cầu.

Tham sốMô tảGiá trị
api_key*Key xác thực để cho gọi dịch vụYOUR_API_KEY
profile*Loại phương tiện di chuyển:
  • car: Đi bằng ô tô
  • bicycle: Đi bằng xe đạp/xe máy
  • foot: Đi bộ
Ví dụ: car
coordinates*Tọa độ bao gồm kinh độ, vĩ độ{longitude},{latitude}
Ví dụ: 105.852433,21.028849
numberSố điểm gần nhất được tìm thấy.Mặc định là 1

Ví dụ Request:

$ curl "https://api.ekgis.vn/navigation/nearest/car/driving/105.852433,21.028849?&api_key={YOUR_API_KEY}"

Response

Trả về đối tượng chỉ đường với các thông tin sau:

  • code: nếu yêu cầu thành công giá trị là Ok
  • waypoints: Mảng đối tượng thông vị trí tọa độ gần nhất trên đường giao thông được sắp xếp theo thứ tự giảm dần theo khoảng cách. Mỗi đối tượng bao gồm thông tin:
    • distance : Khoảng cách từ vị trí truyền vào đến vị trí gần nhất đường giao thông tính bằng mét.
    • location: Cặp tọa độ gần nhất trên đường giao thông {longitude},{latitude}.

Ví dụ dữ liệu trả về dạng JSON:

{
"code": "Ok",
"waypoints": [
{
"nodes": [
75617755,
1497570407
],
"location": [
105.85141,
21.028884
],
"name": "Phố Lê Thái Tổ",
"distance": 106.416237,
"hint": "W1VSgP___38HAAAAEgAAAJcAAABQAAAAXQcMQWl-L0H-kShD_s6wQgcAAAASAAAAlwAAAFAAAACRAgAAEipPBhTgQAERLk8G8d9AAQQAbwswuIh5"
}
]
}