Yêu cầu ma trận tuyến đường lấy dữ liệu đầu vào là một mảng nguồn gốc và đích đến điểm tham chiếu. Sau đó, Routes API tính toán tuyến đường từ mỗi điểm gốc điểm tham chiếu cho từng điểm tham chiếu đích. Ví dụ: nếu bạn chỉ định 2 điểm khởi hành điểm tham chiếu và hai điểm tham chiếu đích, sau đó API sẽ tính toán bốn điểm riêng biệt tuyến đường.
Phản hồi của API chứa một mảng, trong đó mỗi phần tử mảng tương ứng với tuyến từ một điểm tham chiếu gốc tới một điểm tham chiếu đích. Do đó, nếu bạn chỉ định hai điểm tham chiếu gốc và hai điểm tham chiếu đích, mảng phản hồi chứa 4 phần tử, mỗi phần tử cho một tuyến đã tính toán.
Bằng cách sử dụng phản hồi, bạn có thể cung cấp cho khách hàng các lựa chọn tuyến đường khác nhau rồi để người dùng chọn tuyến đường thích hợp với yêu cầu của họ.
Giới thiệu về mặt nạ trường
Khi gọi một phương thức để tính toán một tuyến đường, bạn phải chỉ định một trường mặt nạ xác định các trường bạn muốn được trả về trong phản hồi. Không có danh sách mặc định các trường được trả về. Nếu bạn bỏ qua danh sách này, các phương thức sẽ trả về .
Các ví dụ trong tài liệu này hiển thị toàn bộ đối tượng phản hồi mà không cần lấy mặt nạ thực địa. Trong môi trường phát hành công khai, phản hồi của bạn sẽ chỉ bao gồm các trường mà bạn chỉ định rõ ràng trong mặt nạ trường.
Để biết thêm thông tin, hãy xem phần Chọn thông tin cần trả lại.
Giới thiệu về việc hiển thị bản quyền
Bạn phải đính kèm tuyên bố bản quyền sau đây khi hiển thị kết quả cho người dùng:
Powered by Google, ©YEAR Google
Ví dụ:
Powered by Google, ©2023 Google
Xác định tuyến đường trong phản hồi
Dùng các thuộc tính phản hồi originIndex và destinationIndex để xác định
từng tuyến trong phản hồi. Những cơ sở lưu trú này chứa chỉ mục dựa trên 0 của
điểm tham chiếu đầu vào origin và destination được dùng để tính toán
tuyến đường. Tức là điểm tham chiếu gốc đầu tiên và điểm tham chiếu đích đầu tiên
trong yêu cầu đang ở chỉ mục mảng 0.
Ví dụ: một tuyến trong phản hồi chứa:
"originIndex": 1, "destinationIndex": 0
Những thuộc tính này cho biết rằng tuyến đường được tính toán từ điểm gốc điểm tham chiếu tại chỉ mục 1 trong mảng đầu vào và từ điểm tham chiếu đích tại chỉ mục 0.
Đối với tuyến đường tiếp theo:
"originIndex": 4, "destinationIndex": 1
Tuyến đường được tính từ điểm tham chiếu gốc ở chỉ mục 4 trong đầu vào mảng và từ điểm tham chiếu đích tại chỉ mục 1 trong mảng đầu vào.
Giới thiệu về câu trả lời
Chiến lược phát hành đĩa đơn Đối tượng JSON biểu thị phản hồi của API có chứa một mảng, trong đó mỗi phần tử mảng xác định tuyến từ một điểm tham chiếu gốc tới một điểm tham chiếu đích.
Cùng với các thuộc tính originIndex và destinationIndex, mỗi tuyến
chứa thông tin cụ thể cho tuyến đường đó, chẳng hạn như distanceMeters,
duration và travelAdvisory.
Câu trả lời có dạng:
[
// One array element for each combination of origin and destination waypoints.
{
// The route for source waypoint 0 and destination waypoint 0.
"originIndex": 0,
"destinationIndex": 0,
"status": {
object (Status)
},
"condition": enum (RouteMatrixElementCondition),
"distanceMeters": integer,
"duration": string,
"staticDuration": string,
"travelAdvisory": {
object (RouteTravelAdvisory)
},
"fallbackInfo": {
object (FallbackInfo)
}
}
{
// The route for source waypoint 0 and destination waypoint 1.
"originIndex": 0,
"destinationIndex": 1,
"status": {
object (Status)
},
"condition": enum (RouteMatrixElementCondition),
"distanceMeters": integer,
"duration": string,
"staticDuration": string,
"travelAdvisory": {
object (RouteTravelAdvisory)
},
"fallbackInfo": {
object (FallbackInfo)
}
}
…
]