V2

Tìm đường đi từ điểm A đến điểm B.

Endpoint

https://maps.track-asia.com/route/v2/directions/{outputFormat}

outputFormat

outputFormat	Mô tả
`json` (khuyến nghị)	định dạng JSON
`xml`	định dạng XML

Tham số

Tham số	Giá trị	Mô tả	Ví dụ
`mode`	`driving` (mặc định), `motorcycling` , `walking`	Phương thức di chuyển	driving
`origin`	`{vĩ độ},{kinh độ}` (khuyến nghị) hoặc chuỗi địa chỉ	Tọa độ hoặc chuỗi địa điểm bắt đầu. Nếu truyền chuỗi địa điểm, dịch vụ Directions sẽ tự động chuyển đổi thành tọa độ	10.761,106.68
`destination`	`{vĩ độ},{kinh độ}` (khuyến nghị) hoặc chuỗi địa chỉ	Tọa độ hoặc chuỗi địa điểm kết thúc. Nếu truyền chuỗi địa điểm, dịch vụ Directions sẽ tự động chuyển đổi thành tọa độ	10.795,106.72
`key`	Chuỗi (bắt buộc)	Khóa API	public_key

Mã ví dụ

https://maps.track-asia.com/route/v2/directions/json?origin=10.761,106.68&destination=10.795,106.72&mode=driving&key=public_key

https://maps.track-asia.com/route/v2/directions/xml?origin=10.761,106.68&destination=10.795,106.72&mode=driving&key=public_key

CurlJavascript

curl -G "https://maps.track-asia.com/route/v2/directions/json" \
--data-urlencode "origin=10.761,106.68" \
--data-urlencode "destination=10.795,106.72" \
--data-urlencode "mode=driving" \
--data-urlencode "key=public_key"

const response = await fetch("https://maps.track-asia.com/route/v2/directions/json?origin=10.761,106.68&destination=10.795,106.72&mode=driving&key=public_key")
const data = await response.json()
console.log(data)

Phản hồi

JSON Phản hồi

Phản hồi là một đối tượng JSON với cấu trúc như sau:

routes: Mảng các đối tượng lộ trình. Mỗi lộ trình gồm:
- summary: Tóm tắt tuyến đường (ví dụ: các tuyến phố chính).
- bounds: Đối tượng với northeast và southwest là tọa độ biên của tuyến đường.
- copyrights: Bản quyền dữ liệu.
- legs: Mảng các đoạn (leg), mỗi đoạn gồm:
  - distance: Đối tượng gồm text (dạng đọc được) và value (đơn vị mét).
  - duration: Đối tượng gồm text (dạng đọc được) và value (đơn vị giây).
  - start_address, end_address: Địa chỉ đầu/cuối đoạn.
  - start_location, end_location: Đối tượng có lat và lng.
  - steps: Mảng các bước, mỗi bước gồm:
    - distance, duration: Như trên.
    - start_location, end_location: Như trên.
    - polyline: Polyline mã hóa cho bước này.
    - html_instructions: Hướng dẫn từng bước (HTML).
    - travel_mode: Phương thức di chuyển (ví dụ: "DRIVING").
    - maneuver: Loại thao tác (ví dụ: "turn-right").
- overview_polyline: Polyline mã hóa cho toàn tuyến đường.
- waypoint_order: Mảng thứ tự các điểm dừng.
status: Chuỗi trạng thái (ví dụ: "OK").
geocoded_waypoints: Mảng các đối tượng waypoint đã geocode, mỗi đối tượng gồm:
- geocoder_status: Trạng thái geocoding.
- place_id: Định danh địa điểm.
- types: Mảng loại địa điểm.

Cấu trúc có thể có thêm các trường khác tùy theo tham số truy vấn và phiên bản API.

XML Phản hồi

Phản hồi XML có cấu trúc tương tự, các trường sẽ là các thẻ XML tương ứng với các trường JSON ở trên. Tuy nhiên, có một số khác biệt nhỏ sau:

Kết quả XML được gói trong phần tử gốc <DirectionsResponse>.
JSON biểu thị các mục có nhiều phần tử bằng các mảng số nhiều (như steps và legs), trong khi XML biểu thị các mục này bằng nhiều phần tử đơn lẻ (như <step> và <leg>).
JSON biểu thị thứ tự điểm dừng thông qua trường waypoint_order, trong khi XML biểu thị các mục này bằng các phần tử <waypoint_index> riêng lẻ.
Các phần tử trống được chỉ định thông qua các mảng trống trong JSON, nhưng không có bất kỳ phần tử nào như vậy trong XML. Một phản hồi không tạo ra kết quả nào sẽ trả về một mảng tuyến đường trống trong JSON, nhưng không có phần tử <route> trong XML, chẳng hạn.

Polyline tool

Các bước tiếp theo

Thử API playground