V1

Tính thời gian di chuyển nhanh nhất giữa các cặp tọa độ. Trả về thời gian hoặc khoảng cách hoặc cả hai giữa các cặp tọa độ.

Lưu ý rằng khoảng cách không phải là khoảng cách ngắn nhất giữa hai tọa độ, mà là khoảng cách của tuyến đường nhanh nhất. Thời gian được tính bằng giây và khoảng cách bằng mét. Số lượng nguồn và đích có thể nhỏ hơn hoặc bằng số lượng tọa độ đầu vào.

Endpoint

https://maps.track-asia.com/distance-matrix/v1/{PROFILE}/{COORDINATES}

Tham số

Tham số	Giá trị	Mô tả	Ví dụ
`PROFILE`	`car`, `moto` hoặc `walk`	Phương thức di chuyển	moto
`COORDINATES`	`{kinh độ},{vĩ độ};{kinh độ},{vĩ độ}`	Chuỗi tọa độ	101.1234,10.1234;101.5678,10.5678
`sources`	`{chỉ số};{chỉ số}[;{chỉ số} ...] hoặc all (mặc định)	Sử dụng vị trí theo chỉ số làm điểm xuất phát	0;2
`destinations`	`{chỉ số};{chỉ số}[;{chỉ số} ...] hoặc all (mặc định)	Sử dụng vị trí theo chỉ số làm điểm đến	1;3;4
`annotations`	`duration` (mặc định), `distance`, hoặc `duration,distance`	Trả về bảng khoảng cách hoặc thời gian hoặc cả hai	distance,duration
`fallback_speed`	số thực > 0	Nếu không tìm thấy tuyến đường giữa cặp nguồn/đích, tính khoảng cách đường chim bay và dùng tốc độ này để ước tính thời gian	0.5
`key`	Chuỗi (bắt buộc)	Khóa API	public_key

Mã ví dụ

Trả về ma trận thời gian 2x2

https://maps.track-asia.com/distance-matrix/v1/car/106.1234,10.1234;106.5678,10.5678?key=public_key

Trả về ma trận khoảng cách 3x3

https://maps.track-asia.com/distance-matrix/v1/moto/106.1234,10.1234;106.5678,10.5678;106.5778,10.5998?key=public_key

Trả về ma trận thời gian 1x3

https://maps.track-asia.com/distance-matrix/v1/car/106.1234,10.1234;106.5678,10.5678;106.5778,10.5998?sources=1&key=public_key

Trả về ma trận thời gian 2x3

https://maps.track-asia.com/distance-matrix/v1/car/106.1234,10.1234;106.5678,10.5678;106.5778,10.5998?sources=1;2&destinations=0;1;2&key=public_key

Trả về ma trận thời gian và khoảng cách 3x2

https://maps.track-asia.com/distance-matrix/v1/car/106.1234,10.1234;106.5678,10.5678;106.5778,10.5998?sources=0;1;2&destinations=1;2&annotations=distance,duration&key=public_key

CurlJavascript

curl -G 'https://maps.track-asia.com/distance-matrix/v1/car/106.1234,10.1234;106.5678,10.5678;106.5778,10.5998?sources=1&key=public_key'

const response = await fetch("https://maps.track-asia.com/distance-matrix/v1/car/106.1234,10.1234;106.5678,10.5678;106.5778,10.5998?sources=1;2&destinations=0;1;2&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:

code: Trạng thái của yêu cầu (ví dụ: "Ok").
sources: Mảng các điểm xuất phát, mỗi điểm gồm:
- location: [kinh độ, vĩ độ] của điểm xuất phát.
- name: Tên vị trí xuất phát (nếu có).
destinations: Mảng các điểm đích, mỗi điểm gồm:
- location: [kinh độ, vĩ độ] của điểm đích.
- name: Tên vị trí đích (nếu có).
distances: Ma trận 2 chiều, trong đó distances[i][j] là khoảng cách từ nguồn i đến đích j (đơn vị mét), nếu có yêu cầu.
durations: Ma trận 2 chiều, trong đó durations[i][j] là thời gian di chuyển từ nguồn i đến đích j (đơn vị giây), nếu có yêu cầu.

Các bước tiếp theo

Thử API playground