Distance Matrix API (Phiên bản cũ) là một dịch vụ web trả về quãng đường và thời gian di chuyển cho một ma trận gồm các điểm xuất phát và điểm đến, dựa trên tuyến đường được đề xuất giữa mỗi cặp. Bạn có thể đặt phương thức di chuyển (lái xe, đi bộ, đi xe đạp, phương tiện công cộng), chế độ phương tiện công cộng, đơn vị và thời gian khởi hành cho thời gian dựa trên tình hình giao thông. API này trả về JSON hoặc XML.
Distance Matrix API: thông tin chính
- Sản phẩm: Distance Matrix API
- Còn gọi là: Distance Matrix API (Phiên bản cũ), Distance Matrix (Phiên bản cũ)
- Danh mục: Tuyến đường
- Nền tảng: Dịch vụ web (REST)
- Chạy trên: Máy chủ (mã phụ trợ)
- Giai đoạn ra mắt: GA
- Vòng đời: Cũ
- Được thay thế bằng: Routes API
- Tổng quan: Tổng quan về Distance Matrix API
Distance Matrix API: trường hợp sử dụng
Sử dụng Distance Matrix API khi:
- Bạn duy trì một dự án hiện có đã bật Distance Matrix API (Phiên bản cũ) và gọi
/maps/api/distancematrix. - Bạn cần có quãng đường và thời gian di chuyển giữa từng điểm xuất phát và từng điểm đến từ một máy chủ.
- Bạn cần có thời gian di chuyển trong tình trạng giao thông khi lái xe, sử dụng
departure_timevàtraffic_model(không bắt buộc).
Đừng sử dụng Distance Matrix API khi:
- Bạn đang bắt đầu một dự án trên đám mây mới trên Google Cloud. Kể từ tháng 10 năm 2026, bạn không thể bật Distance Matrix API (Phiên bản cũ) cho các dự án mới. Hãy sử dụng Routes API.
- Bạn cần các tính năng mới hoặc một ma trận tuyến đường có tối đa 625 phần tử với phản hồi được truyền trực tuyến (
computeRouteMatrix). Hãy sử dụng Routes API. - Bạn cần có một tuyến đường đầy đủ với các bước và hình nhiều đường giữa các điểm, chứ không chỉ các giá trị về khoảng cách và thời gian. Hãy sử dụng Routes API.
Distance Matrix API: thiết lập
- Dịch vụ cần bật:
distance-matrix-backend.googleapis.com - Xác thực: Khoá API
- Bắt đầu: Thiết lập Distance Matrix API
- Tài liệu tham khảo: Tài liệu tham khảo về Distance Matrix API
- Giá: Mức sử dụng và thanh toán cho Distance Matrix API
- Chính sách: Chính sách về Distance Matrix API
- Ghi chú phát hành: Ghi chú phát hành về Distance Matrix API
Distance Matrix API: các lỗi thường gặp
- Vấn đề: Mỗi yêu cầu phía máy chủ chỉ được chứa tối đa 100 phần tử (nguồn × đích đến) và 25 nguồn hoặc 25 đích đến. Các yêu cầu lớn hơn sẽ trả về
MAX_ELEMENTS_EXCEEDEDhoặcMAX_DIMENSIONS_EXCEEDED. Cách khắc phục: Chia ma trận thành các yêu cầu có không quá 100 phần tử và 25 điểm xuất phát hoặc điểm đến. Hãy xem /maps/documentation/distance-matrix/usage-and-billing#usage-limits. - Vấn đề: Nếu bạn không chỉ định
departure_time, thì tuyến đường và thời gian sẽ dựa trên lưu lượng truy cập trung bình không phụ thuộc vào thời gian và không códuration_in_trafficnào được trả về. Kết quả có thể thay đổi theo thời gian. Cách khắc phục: Đặtdeparture_timethànhnowhoặc một thời điểm trong tương lai bằngmode=drivingđể nhận được thời lượng có tính đến tình hình giao thông. Xin lưu ý rằng các yêu cầu về thông tin giao thông sẽ được tính phí ở mức cao hơn. Xem /maps/documentation/distance-matrix/distance-matrix. - Vấn đề: Tham số
unitschỉ thay đổi văn bản trong các trường khoảng cách. Giá trị khoảng cách luôn được tính bằng mét. Cách khắc phục: Đọcdistance.valuelà mét hoặc sử dụngdistance.textđể hiển thị. Xem /maps/documentation/distance-matrix/distance-matrix. - Vấn đề: Việc gọi Distance Matrix API (Phiên bản cũ) từ một dự án chưa bật API này sẽ trả về
REQUEST_DENIEDtrongstatusvà mộterror_messageliên kết đếnLegacyApiNotActivatedMapError. Theo mặc định, trợ lý AI thường tạo mã API cũ. Cách khắc phục: Di chuyển sang Routes APIcomputeRouteMatrix(bằng tiêu đềX-Goog-FieldMask). Chỉ kích hoạt API cũ bằng biểu mẫu như một biện pháp ngắn hạn. Hãy xem /maps/legacy#LegacyApiNotActivatedMapError.