Distance Matrix API

Matrix API tính toán thời gian di chuyển và khoảng cách giữa mọi tổ hợp điểm xuất phát và điểm đến trong một yêu cầu duy nhất. Các trường hợp sử dụng điển hình bao gồm tìm tài xế hoặc kỹ thuật viên gần nhất với công việc, giải quyết bài toán định tuyến phương tiện, ước tính khung thời gian giao hàng cho khách hàng, và tính toán vùng phủ sóng khu vực dịch vụ cho quy hoạch cơ sở.

Directions API trả về một tuyến đường chi tiết duy nhất giữa hai điểm, bao gồm hướng dẫn rẽ và hình học. Matrix API trả về bảng khoảng cách và thời gian cho nhiều cặp xuất phát-đến mà không có hình học tuyến đường. Nếu bạn cần so sánh nhiều địa điểm một cách hiệu quả, Matrix API nhanh hơn và tiết kiệm chi phí hơn so với việc thực hiện các lần gọi Directions riêng lẻ.

API hỗ trợ ma trận lên đến 100 điểm xuất phát nhân 100 điểm đến trong một yêu cầu, cho tối đa 10.000 cặp xuất phát-đến mỗi lần gọi. Ma trận không cần phải là hình vuông: bạn có thể gửi 1 điểm xuất phát nhân 100 điểm đến để tra cứu vị trí gần nhất, hoặc 50 nhân 50 cho phân công đội xe đầy đủ cho khách hàng.

Matrix API hỗ trợ lái xe, đi bộ, đạp xe và giao thông công cộng. Chế độ di chuyển được đặt theo từng yêu cầu. Tất cả các cặp trong một yêu cầu sử dụng cùng một chế độ. Nếu bạn cần kết quả đa chế độ, hãy gửi các yêu cầu riêng biệt cho mỗi chế độ và hợp nhất các phản hồi trong ứng dụng của bạn.

Theo mặc định, Matrix API sử dụng tốc độ đường bộ dòng chảy tự do đại diện cho điều kiện di chuyển thông thường. Thời gian được điều chỉnh theo giao thông thời gian thực có sẵn trên các gói đủ điều kiện. Đặt tham số departure_time thành dấu thời gian trong tương lai để nhận ước tính di chuyển theo thời gian trong ngày dựa trên các mẫu giao thông lịch sử.

Gửi vị trí truy vấn duy nhất của bạn làm điểm xuất phát và danh sách các vị trí ứng viên làm điểm đến. API trả về thời gian di chuyển và khoảng cách từ điểm truy vấn đến mọi ứng viên trong một lần gọi. Sắp xếp phản hồi theo thời gian để tìm tùy chọn gần nhất. Điều này hiệu quả hơn đáng kể so với việc gọi Directions API trong vòng lặp cho mỗi ứng viên.