封裝在 v1alpha.computeRouteMatrix API 中為起點/目的地組合計算的路線資訊。這個 proto 可串流至用戶端。
JSON 表示法 |
---|
{ "originIndex": integer, "destinationIndex": integer, "status": { object ( |
欄位 | |
---|---|
originIndex |
要求中的來源,從零開始。 |
destinationIndex |
要求中的目的地索引 (從零開始)。 |
status |
這個元素的錯誤狀態碼。 |
condition |
用於指出是否已找到路線。與狀態無關。 |
distanceMeters |
路線的移動距離 (以公尺為單位)。 |
duration |
導航路線所需的時間。如果將 持續時間以秒為單位,最多 9 個小數位數,結尾為「 |
staticDuration |
行經路線時未將路況納入考量。 持續時間以秒為單位,最多 9 個小數位數,結尾為「 |
travelAdvisory |
路線的其他資訊。例如:限制資訊和收費資訊 |
fallbackInfo |
在某些情況下,當伺服器無法根據此特定起點/目的地組合的指定偏好設定計算路線時,可能會改回採用其他計算模式。如果您使用備用模式,這個欄位會包含備用回應的詳細資訊。否則就不會設定這個欄位。 |
狀態
Status
類型會定義適用於不同程式設計環境 (包含 REST API 和遠端程序呼叫 (RPC) API) 的邏輯錯誤模型。gRPC 會使用這個模型。每個 Status
訊息包含三部分的資料:錯誤代碼、錯誤訊息和錯誤詳細資料。
如要進一步瞭解這個錯誤模型,以及如何使用這個錯誤模型,請參閱 API 設計指南。
JSON 表示法 |
---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
欄位 | |
---|---|
code |
狀態碼,應為 |
message |
向開發人員顯示的錯誤訊息,應以英文呈現。任何向使用者顯示的錯誤訊息都應進行本地化並透過 |
details[] |
包含錯誤詳細資料的訊息清單。這是供 API 使用的一組常用訊息類型。 包含任意類型欄位的物件。額外的 |