RouteMatrixElement

封裝在 v1alpha.computeRouteMatrix API 中為起點/目的地組合計算的路線資訊。這個 proto 可串流至用戶端。

JSON 表示法 
{
  "originIndex": integer,
  "destinationIndex": integer,
  "status": {
    object (Status)
  },
  "condition": enum (RouteMatrixElementCondition),
  "distanceMeters": integer,
  "duration": string,
  "staticDuration": string,
  "travelAdvisory": {
    object (RouteTravelAdvisory)
  },
  "fallbackInfo": {
    object (FallbackInfo)
  }
}
欄位
originIndex

integer

要求中的來源，從零開始。
destinationIndex

integer

要求中的目的地索引 (從零開始)。
status

object (Status)

這個元素的錯誤狀態碼。
condition

enum (RouteMatrixElementCondition)

用於指出是否已找到路線。與狀態無關。
distanceMeters

integer

路線的移動距離 (以公尺為單位)。
duration

string (Duration format)

導航路線所需的時間。如果將 routingPreference 設為 TRAFFIC_UNAWARE，則這個值與 staticDuration 相同。如果您將 routingPreference 設為 TRAFFIC_AWARE 或 TRAFFIC_AWARE_OPTIMAL，這個值會將路況納入考量。

持續時間以秒為單位，最多 9 個小數位數，結尾為「s」，例如："3.5s"。
staticDuration

string (Duration format)

行經路線時未將路況納入考量。

持續時間以秒為單位，最多 9 個小數位數，結尾為「s」，例如："3.5s"。
travelAdvisory

object (RouteTravelAdvisory)

路線的其他資訊。例如：限制資訊和收費資訊
fallbackInfo

object (FallbackInfo)

在某些情況下，當伺服器無法根據此特定起點/目的地組合的指定偏好設定計算路線時，可能會改回採用其他計算模式。如果您使用備用模式，這個欄位會包含備用回應的詳細資訊。否則就不會設定這個欄位。

狀態

Status 類型會定義適用於不同程式設計環境 (包含 REST API 和遠端程序呼叫 (RPC) API) 的邏輯錯誤模型。gRPC 會使用這個模型。每個 Status 訊息包含三部分的資料：錯誤代碼、錯誤訊息和錯誤詳細資料。

如要進一步瞭解這個錯誤模型，以及如何使用這個錯誤模型，請參閱 API 設計指南。

JSON 表示法 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
欄位
code

integer

狀態碼，應為 google.rpc.Code 的列舉值。
message

string

向開發人員顯示的錯誤訊息，應以英文呈現。任何向使用者顯示的錯誤訊息都應進行本地化並透過 google.rpc.Status.details 欄位傳送，或是由用戶端加以本地化。
details[]

object

包含錯誤詳細資料的訊息清單。這是供 API 使用的一組常用訊息類型。

包含任意類型欄位的物件。額外的 "@type" 欄位則包含能辨識類型的 URI。例如：{ "id": 1234, "@type": "types.example.com/standard/id" }.