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 nguồn 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 lượng số của nguồn gốc và đích đến:

• Tổng số lượng nguồn gốc + số lượng đích đến được chỉ định là placeId hoặc address không được lớn hơn 50.
• Tích số của số nguồn gốc × số lượng đích đến không được lớn hơn 625 trong mọi trường hợp.
• Tích của số lượng nguồn gốc × số lượng đích đến không được lớn hơn 100 nếu tính năng định tuyến được đặt thành TRAFFIC_AWARE_OPTIMAL.
• Tích của số lượng nguồn gốc × số lượng điểm đến không được lớn hơn 100 nếuTravelMode được đặt thành TRANSIT.

object (RouteMatrixDestination)

Bắt buộc. Mảng các đích đến 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 thức di chuyển.

enum (RoutingPreference)

Không bắt buộc. Chỉ định cách tính toán tuyến. Máy chủ cố gắng sử dụng tuỳ chọ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á dài, thì hệ thống sẽ trả về lỗi. 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 theo thời gian bạn thực hiện 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, với độ phân giải nano giây và tối đa 9 chữ số phân số. 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 Ý: 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 thể chỉ định cả hai.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. 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 Mã nhận dạng ngôn ngữ Unicode. Xem trang Hỗ trợ ngôn ngữ để biết danh sách các 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ạng ccTLD (miền cấp cao nhất) gồm 2 ký tự. Để biết thêm thông tin, hãy xem phần Miền cấp cao nhất của 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ể dùng để hoàn tất yêu cầu. Lưu ý: Những phép tính bổ sung này có thể trả về các trường bổ sung trong câu trả lời. Các trường bổ sung này cũng phải được chỉ định trong mặt nạ trường (field mask) để được trả về trong phản hồi.

enum (TrafficModel)

Không bắt buộc. Nêu các giả định cần sử dụng khi tính thời gian 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 thời lượng trong RouteMatrixElement, chứa thời gian dự đoán cho lưu lượng truy cập dựa trên mức trung bình trước đây. RoutingPreference đến TRAFFIC_AWARE_OPTIMAL và RouteTravelMode thành DRIVE. Giá trị 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 lựa chọn ưu tiên ảnh hưởng đến tuyến được trả về cho các tuyến TRANSIT. LƯU Ý: Bạn chỉ có thể chỉ định transitPreferences khi RouteTravelMode được đặt thành TRANSIT.