RouteMatrixElement

封裝在 v1alpha.computeRouteMatrix API 中針對起點/目的地組合計算出的路線資訊。此原型可以串流至用戶端。

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" }。