封裝在 v1alpha.computeRouteMatrix API 中針對起點/目的地組合計算出的路線資訊。此原型可以串流至用戶端。
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 使用的一組常用訊息類型。 包含任意類型欄位的物件。額外的 |