計算路徑矩陣

您可以使用 Routes Preferred API 的 ComputeRouteMatrix 方法,計算多個起點和目的地的路線距離和所需時間。ComputeRouteMatrix 支援串流 gRPC 呼叫和 REST HTTP 呼叫。

ComputeRouteMatrix 會根據起點與目的地組合的清單,計算從每個起點開始,並在每個目的地結束的路線距離和時間。串流的每個元素都對應單一路線的資訊。

與距離矩陣服務相比,ComputeRouteMatrix 方法有以下幾個優點:

  • 串流允許在計算整個矩陣之前傳回元素,減少延遲時間。
  • ComputeRouteMatrix 提供精細的流量計算選項,可讓您做出品質延遲的取捨。
  • 要求在 Google 基礎架構中的優先順序較高,因此可用性較高。
  • 您可以為路線控點指定方向 (旅遊方向) 和道路側面資訊。
  • 您可以要求傳回收費資訊、路線距離和預計到達時間。

啟用 ComputeRouteMatrix 方法

您必須先啟用 ComputeRouteMatrix 方法,才能在程式碼中使用。如要進一步瞭解如何啟用 Routes Preferred API 方法,請參閱入門指南

使用 ComputeRouteMatrix 方法

ComputeRouteMatrix 方法可透過 Routes Preferred v1 端點使用。

詳情請參閱以下說明文件:

gRPC:https://developers.google.com/maps/documentation/routes_preferred/reference/rpc/google.maps.routes.v1

REST:https://developers.google.com/maps/documentation/routes_preferred/reference/rest/v1/TopLevel/computeRouteMatrix

以下通用步驟說明如何使用 gRPC 呼叫 ComputeRouteMatrix 方法:

  1. 請從 googleapis 存放區查看必要的 protobuffer:

    https://github.com/googleapis/googleapis/tree/master/google/maps/routes

    請注意,部分建構系統 (例如 Go) 可能會自動執行這項作業。

  2. 使用您偏好的語言和一組建構工具,產生相關的 Protobuffer 程式碼。

  3. 產生要求。傳送要求時,必須一併傳送下列兩項中繼資料:

    • 您必須將 X-Goog-Api-Key 設為 API 金鑰。
    • X-Goog-Fieldmask 必須設為回應您所需的欄位清單,並以逗號分隔。例如 X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status。 您可以使用萬用字元 (*) 表示所有欄位,但不建議這麼做。請使用萬用字元來測試及瞭解 API 回應,但在實際執行程式碼的欄位遮罩中,明確列出所需的欄位。

      如要進一步瞭解如何建構欄位遮罩字串,請參閱 https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/field_mask.proto。請注意,停用不需要的欄位可以縮短延遲時間,因為這些欄位可能需要進一步計算。如果您指定了所需的欄位,之後會新增需要更多運算的新欄位,延遲時間將可保持穩定。

  4. 將要求傳送至 routespreferred.googleapis.com:443,必須使用傳輸層安全標準 (TLS) 通訊協定。

如需 ComputeRouteMatrix 方法的使用範例,請參閱計算路徑矩陣 (Beta 版) 範例

ComputeRouteMatrix 方法的其中一項特色是,您可以針對整個串流或個別元素傳回錯誤代碼。舉例來說,如果要求格式錯誤 (例如沒有來源為零),串流連線會傳回錯誤。不過,如果只有串流的幾個元素會發生錯誤 (例如為來源設定無效的地點 ID),則只有受錯誤影響的元素會包含錯誤代碼。

串流傳回的元素不保證會以任何順序傳回。因此,每個元素都包含 origin_indexdestination_index。針對要求指定的起點和目的地,路線起點等同於指定元素的 origins[origin_index],且路徑目的地等同於 destinations[destination_index]。這些陣列是從零開始索引。請務必儲存起點和目的地清單的訂單。

計算過路費

如要進一步瞭解如何計算過路費,請參閱「計算過路費」。

如需計算通行費的範例,請參閱計算路徑矩陣範例