Xem xét phản hồi ma trận tuyến đường

Yêu cầu ma trận tuyến đường sẽ nhận một mảng các điểm tham chiếu về điểm xuất phát và điểm đến làm dữ liệu đầu vào. Sau đó, Routes API sẽ tính toán tuyến đường từ mỗi điểm tham chiếu về điểm xuất phát đến mỗi điểm tham chiếu về điểm đến. Ví dụ: nếu bạn chỉ định 2 điểm tham chiếu về điểm xuất phát và 2 điểm tham chiếu về điểm đến, thì API sẽ tính toán 4 tuyến đường riêng biệt.

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 đường từ một điểm tham chiếu về điểm xuất phát đến một điểm tham chiếu về điểm đến. Do đó, nếu bạn chỉ định 2 điểm tham chiếu về điểm xuất phát và 2 điểm tham chiếu về điểm đến, thì mảng phản hồi sẽ chứa 4 phần tử, mỗi phần tử cho một tuyến đường được tính toán.

Khi sử dụng phản hồi này, bạn có thể cung cấp cho khách hàng nhiều lựa chọn tuyến đường, sau đó cho phép người dùng chọn tuyến đường phù 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 tuyến đường, bạn phải chỉ định một mặt nạ trường xác định những trường mà bạn muốn trả về trong phản hồi. Không có danh sách mặc định về 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ề lỗi.

Các ví dụ trong tài liệu này cho thấy toàn bộ đối tượng phản hồi mà không xem xét đến mặt nạ trường. Trong môi trường thực tế, 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 bài viết Chọn thông tin cần trả về.

Giới thiệu về việc hiển thị bản quyền

Bạn phải đưa câu 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

Sử dụng các thuộc tính phản hồi originIndex và destinationIndex để xác định từng tuyến đường trong phản hồi. Các thuộc tính này chứa chỉ mục dựa trên 0 của các điểm tham chiếu về điểm xuất phát và điểm đến đầu vào được dùng để tính toán tuyến đường. Điều đó có nghĩa là điểm tham chiếu về điểm xuất phát đầu tiên và điểm tham chiếu về điểm đến đầu tiên trong yêu cầu nằm ở chỉ mục mảng 0.

Ví dụ: một tuyến đường trong phản hồi chứa:

"originIndex": 1,
"destinationIndex": 0

Các thuộc tính này cho biết rằng tuyến đường được tính toán từ điểm tham chiếu về điểm xuất phát ở chỉ mục 1 trong mảng đầu vào và từ điểm tham chiếu về điểm đến ở chỉ mục 0.

Đối với tuyến đường tiếp theo:

"originIndex": 4,
"destinationIndex": 1

Tuyến đường được tính toán từ điểm tham chiếu về điểm xuất phát ở chỉ mục 4 trong mảng đầu vào và từ điểm tham chiếu về điểm đến ở chỉ mục 1 trong mảng đầu vào.

Giới thiệu về phản hồi

Đối tượng JSON đại diện cho phản hồi của API chứa một mảng, trong đó mỗi phần tử mảng xác định tuyến đường từ một điểm tham chiếu về điểm xuất phát đến một điểm tham chiếu về điểm đến.

Cùng với các thuộc tính originIndex và destinationIndex, mỗi tuyến đường chứa thông tin cụ thể cho tuyến đường đó, chẳng hạn như distanceMeters, duration và travelAdvisory.

Phản hồ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)
    }
  }
  …
]