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 可用用戶端程式庫的清單，請參閱「用戶端程式庫」。

後續步驟