Method: computeRouteMatrix

{
  "origins": [
    {
      object (RouteMatrixOrigin)
    }
  ],
  "destinations": [
    {
      object (RouteMatrixDestination)
    }
  ],
  "travelMode": enum (RouteTravelMode),
  "routingPreference": enum (RoutingPreference),
  "departureTime": string,
  "arrivalTime": string,
  "languageCode": string,
  "regionCode": string,
  "units": enum (Units),
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "trafficModel": enum (TrafficModel),
  "transitPreferences": {
    object (TransitPreferences)
  }
}

object (RouteMatrixOrigin)

Bắt buộc. Mảng gốc xác định các hàng của ma trận phản hồi. Một số quy định hạn chế về kích thước áp dụng cho số lượng giá trị riêng biệt của nguồn và đích:

• Tổng số lượng điểm xuất phát + số lượng điểm đến được chỉ định là placeId hoặc address không được lớn hơn 50.
• Trong mọi trường hợp, tích của số lượng điểm xuất phát × số lượng điểm đến không được lớn hơn 625.
• Sản phẩm của số lượng điểm xuất phát × số lượng điểm đến không được lớn hơn 100 nếu bạn đặt routingPreference thành TRAFFIC_AWARE_OPTIMAL.
• Sản phẩm của số lượng điểm xuất phát × số lượng điểm đến không được lớn hơn 100 nếu travelMode được đặt thành TRANSIT.

object (RouteMatrixDestination)

Bắt buộc. Mảng đích xác định các cột của ma trận phản hồi.

enum (RouteTravelMode)

Không bắt buộc. Chỉ định phương tiện giao thông.

enum (RoutingPreference)

Không bắt buộc. Chỉ định cách tính toán tuyến đường. Máy chủ sẽ cố gắng sử dụng lựa chọn ưu tiên định tuyến đã chọn để tính toán tuyến. Nếu tuỳ chọn định tuyến dẫn đến lỗi hoặc độ trễ quá lâu, thì lỗi sẽ được trả về. Bạn chỉ có thể chỉ định tuỳ chọn này khi travelMode là DRIVE hoặc TWO_WHEELER, nếu không yêu cầu sẽ không thành công.

string (Timestamp format)

Không bắt buộc. Thời gian khởi hành. Nếu bạn không đặt giá trị này, thì giá trị này sẽ mặc định là thời điểm bạn đưa ra yêu cầu. LƯU Ý: Bạn chỉ có thể chỉ định departureTime trong quá khứ khi RouteTravelMode được đặt thành TRANSIT.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

string (Timestamp format)

Không bắt buộc. Thời gian đến. LƯU Ý: Bạn chỉ có thể đặt khi RouteTravelMode được đặt thành TRANSIT. Bạn có thể chỉ định departureTime hoặc arrivalTime, nhưng không được chỉ định cả hai.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

string

Không bắt buộc. Mã ngôn ngữ BCP-47, chẳng hạn như "en-US" hoặc "sr-Latn". Để biết thêm thông tin, hãy xem phần Giá trị nhận dạng ngôn ngữ Unicode. Hãy xem phần Hỗ trợ ngôn ngữ để biết danh sách ngôn ngữ được hỗ trợ. Khi bạn không cung cấp giá trị này, ngôn ngữ hiển thị sẽ được suy ra từ vị trí của nguồn gốc đầu tiên.

string

Không bắt buộc. Mã vùng, được chỉ định dưới dạng giá trị gồm hai ký tự ccTLD ("miền cấp cao nhất"). Để biết thêm thông tin, hãy xem bài viết Miền cấp cao nhất theo mã quốc gia.

enum (Units)

Không bắt buộc. Chỉ định đơn vị đo lường cho các trường hiển thị.

enum (ExtraComputation)

Không bắt buộc. Danh sách các phép tính bổ sung có thể được dùng để hoàn tất yêu cầu. Lưu ý: Các phép tính bổ sung này có thể trả về các trường bổ sung trong phản hồi. Bạn cũng phải chỉ định các trường bổ sung này trong mặt nạ trường để được trả về trong phản hồi.

enum (TrafficModel)

Không bắt buộc. Chỉ định các giả định cần sử dụng khi tính thời gian trong lưu lượng truy cập. Chế độ cài đặt này ảnh hưởng đến giá trị được trả về trong trường duration (thời lượng) trong RouteMatrixElement. Trường này chứa thời gian dự đoán trong lưu lượng truy cập dựa trên mức trung bình trong quá khứ. RoutingPreference đến TRAFFIC_AWARE_OPTIMAL và RouteTravelMode đến DRIVE. Mặc định là BEST_GUESS nếu lưu lượng truy cập được yêu cầu và TrafficModel không được chỉ định.

object (TransitPreferences)

Không bắt buộc. Chỉ định các tuỳ chọn ưu tiên ảnh hưởng đến tuyến đường được trả về cho các tuyến đường TRANSIT. LƯU Ý: Bạn chỉ có thể chỉ định transitPreferences khi RouteTravelMode được đặt thành TRANSIT.