Route API
Tìm đường đi giữa các điểm với Vietmap Route API
Chỉ dẫn
Chọn điểm đi/đến rồi bấm "Tính toán tuyến đường" để xem kết quả.
Code mẫu
Ví dụ với tham số mẫu — điền tham số ở khung bên trái để có code đúng request của bạn.
curl 'https://maps.vietmap.vn/api/route/v4?apikey=YOUR_API_KEY&point=21.0285,105.8542&point=21.0368,105.8346&points_encoded=false&vehicle=car&alternative=false&annotations=toll,congestion,congestion_distance'Thay YOUR_API_KEY bằng API key của bạn trước khi chạy.
// Khi đưa vào sản phẩm, đọc key từ biến môi trường thay vì ghi cứng.
const API_KEY = "YOUR_API_KEY";
const params = new URLSearchParams([
["apikey", API_KEY],
["point", "21.0285,105.8542"],
["point", "21.0368,105.8346"],
["points_encoded", "false"],
["vehicle", "car"],
["alternative", "false"],
["annotations", "toll,congestion,congestion_distance"],
]);
const response = await fetch(`https://maps.vietmap.vn/api/route/v4?${params}`);
if (!response.ok) {
throw new Error(`Vietmap ${response.status}: ${await response.text()}`);
}
const data = await response.json();
console.log(data);Thay YOUR_API_KEY bằng API key của bạn trước khi chạy.
import requests
# Khi đưa vào sản phẩm, đọc key từ biến môi trường thay vì ghi cứng.
API_KEY = "YOUR_API_KEY"
params = [
("apikey", API_KEY),
("point", "21.0285,105.8542"),
("point", "21.0368,105.8346"),
("points_encoded", "false"),
("vehicle", "car"),
("alternative", "false"),
("annotations", "toll,congestion,congestion_distance"),
]
response = requests.get("https://maps.vietmap.vn/api/route/v4", params=params, timeout=30)
response.raise_for_status()
print(response.json())Thay YOUR_API_KEY bằng API key của bạn trước khi chạy.
https://maps.vietmap.vn/api/route/v4?apikey=YOUR_API_KEY&point=21.0285,105.8542&point=21.0368,105.8346&points_encoded=false&vehicle=car&alternative=false&annotations=toll,congestion,congestion_distanceThay YOUR_API_KEY bằng API key của bạn trước khi chạy.
Tôi cần tích hợp Route API v4 của Vietmap vào ứng dụng của mình.
Tài liệu chính thức: https://maps.vietmap.vn/docs/map-api/route-version/route-v4/
Đây là một request mẫu đã chạy được trên Vietmap API Playground:
GET https://maps.vietmap.vn/api/route/v4?apikey=YOUR_API_KEY&point=21.0285,105.8542&point=21.0368,105.8346&points_encoded=false&vehicle=car&alternative=false&annotations=toll,congestion,congestion_distance
Tham số đang dùng:
- point = 21.0285,105.8542
- point = 21.0368,105.8346
- points_encoded = false
- vehicle = car
- alternative = false
- annotations = toll,congestion,congestion_distance
Hãy viết code bằng [ngôn ngữ / framework của tôi] để gọi API này, với các yêu cầu:
1. Đọc API key từ biến môi trường VIETMAP_API_KEY, không ghi cứng trong code.
2. Truyền tham số qua query string đúng như request mẫu; tham số lặp lại (như `point`) phải giữ nguyên thứ tự.
3. Xử lý lỗi theo mã HTTP của Vietmap:
- 401: API key sai hoặc đã bị thu hồi.
- 403: key bị giới hạn theo domain / IP không khớp.
- 423: API chưa được bật cho consumer của key, HOẶC tài khoản hết credit — phân biệt bằng nội dung phản hồi (có cụm "exceeded credit" là hết credit).
- 429: vượt giới hạn tần suất — thử lại với backoff tăng dần.
4. Đặt timeout cho request, và định nghĩa kiểu dữ liệu (type / interface / dataclass) cho phản hồi.
Nếu không chắc tên một trường, tra trong tài liệu ở link trên thay vì đoán.Dán vào ChatGPT, Claude… để sinh code tích hợp. Prompt không bao giờ chứa API key của bạn.
https://tools.vietmap.vn/playground/route?point=21.0285,105.8542&point=21.0368,105.8346&version=v4&vehicle=car&annotations=toll,congestion,congestion_distanceMở Playground với đúng các tham số này — dùng để gắn vào tài liệu hoặc gửi đồng nghiệp. Link không chứa API key.
Route API là gì?
Route API là gì?
Route API là API chỉ đường của Vietmap: tìm đường đi qua hai điểm trở lên theo đúng thứ tự cho ô tô, xe máy, xe tải, xe đạp hoặc đi bộ. Kết quả gồm quãng đường, thời gian, đường đi để vẽ lên bản đồ và chỉ dẫn từng chặng. Phiên bản v4 trả thêm phí đường bộ và mức độ ùn tắc trên từng đoạn, có thể tránh trạm thu phí, đặt giờ khởi hành, hướng xuất phát và tải trọng xe tải, kèm các tuyến thay thế.
Dùng để làm gì
- Ước tính thời gian giao hàng, thời gian đến nơi.
- Chỉ đường trong app tài xế, app đi lại.
- Tính phí vận chuyển theo quãng đường thực tế và phí cầu đường.
- So sánh tuyến cho xe máy, ô tô và xe tải.
Request mẫu
GET https://maps.vietmap.vn/api/route/v4?apikey=YOUR_API_KEY&point=21.0285,105.8542&point=21.0368,105.8346&vehicle=motorcycle&points_encoded=falseLặp lại point cho mỗi điểm, theo thứ tự đi; tọa độ là vĩ độ,kinh độ.
Câu hỏi thường gặp về Route API
- Route API hỗ trợ những loại phương tiện nào?
- Ô tô, xe máy, xe tải, xe đạp và đi bộ. Với xe tải, v4 nhận thêm tải trọng để chọn tuyến phù hợp.
- API chỉ đường có tính phí cầu đường không?
- Có. Route API v4 trả phí đường bộ trên tuyến và có tùy chọn tránh trạm thu phí. Nếu đã có hành trình GPS thật và cần đối soát phí, dùng Map Matching API.
- Route API khác gì TSP API?
- Route đi qua các điểm đúng thứ tự bạn gửi. TSP tự sắp lại thứ tự ghé để quãng đường ngắn nhất. Chưa biết thứ tự tối ưu thì dùng TSP; có nhiều xe thì dùng VRP.
- Dùng thử Route API có mất phí không?
- Trên Playground có sẵn API key demo để gọi thử Route API ngay trên trình duyệt, không cần đăng ký. Khi tích hợp vào sản phẩm, bạn đăng ký tài khoản VIETMAP để có API key riêng. Phí tính theo transaction, mỗi API quy đổi số request ra transaction theo tỉ lệ riêng; chi tiết và chương trình trải nghiệm miễn phí có trong bảng giá.