Compute Route Matrix 簡介

歐洲經濟區 (EEA) 開發人員

Compute Route Matrix 是 Routes API 服務中的方法，可接受 HTTPS 要求，並傳回不同起點和目的地之間路線矩陣的距離和移動時間。計算多個目的地之間的行程時間和距離，最多可包含 625 個路線元素。

需要行車路線嗎？如要瞭解路線指引，請參閱「Compute Routes 總覽」。

要遷移嗎？如要從 Distance Matrix API (舊版) 遷移，請參閱「為何要遷移至 Routes API」一文，瞭解遷移操作說明。

使用 Compute Route Matrix 的好處

使用 Compute Route Matrix，您可以判斷最有效率的路線，以安排調度時間，例如：

  • 如何指派一組工作人員領取一系列包裹

  • 判斷最適合出貨的倉庫，將包裹運送至最終目的地

Compute Route Matrix 的用途

使用 Compute Route Matrix，即可取得多個起點和終點之間可能路線的矩陣。每個伺服器端要求可指定多個出發地和目的地，出發地數量乘以目的地數量最多可達 625 個。您可以在計算完整矩陣前串流回應元素，縮短回應延遲時間。

您可以要求這類路線資料，判斷在多個起點和目的地之間，為乘客、貨物或工作人員規劃路線的最有效率方式：

  • 所選交通方式的距離 (公里或英里)

  • 預估交通時間

Compute Route Matrix 的運作方式

ComputeRouteMatrix 方法會接受 HTTP POST 要求，以及包含要求詳細資料的 JSON 要求主體。至少需要一個起點、兩個以上的目的地、travelMode，以及指定要傳回哪些欄位的欄位遮罩。

範例

curl -X POST -d '{
  "origins": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420761,
            "longitude": -122.081356
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.403184,
            "longitude": -122.097371
          }
        }
      }
    }
  ],
  "destinations": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420999,
            "longitude": -122.086894
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.383047,
            "longitude": -122.044651
          }
        }
      }
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \
'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'

回應包含所有起點和目的地中途點組合的可能路線。

資源

下表摘要列出透過 Routes API Compute Route Matrix 方法提供的資源，以及傳回的資料。

資料資源 傳回的資料 傳回格式
ComputeRouteMatrix 傳回從一個起點航點到一個目的地航點的路線陣列。 JSON

如何使用 Compute Route Matrix

1 做好準備 請先按照「設定 Google Cloud 專案」一文中的操作說明完成設定。
2 瞭解 Routes API 的計費方式 詳情請參閱「用量與計費」。
3 計算路線矩陣並檢查回應 詳情請參閱「取得路徑矩陣」和「查看路徑矩陣回應」。

可用的用戶端程式庫

如需 Compute Route Matrix 適用的用戶端程式庫清單，請參閱用戶端程式庫。

後續步驟