Routes API を使用して、computeRouteMatrix メソッド（REST）またはストリーミング ComputeRouteMatrix メソッド（gRPC）を呼び出し、複数の出発地と目的地の経路の距離と所要時間を計算します。
このメソッドは、出発地と目的地のリストを受け取り、各出発地から各目的地に至るルートの距離と所要時間を計算します。
交通機関のルート マトリックスを取得する
交通機関のルート マトリックスを計算することもできます。例については、公共交通機関のルート マトリックスを取得するをご覧ください。
リクエストに関する上限
Compute Route Matrix メソッドでは、住所または場所 ID を使用するウェイポイントと要素に対して、次のリクエスト上限が適用されます。要素は、ルート マトリックス内の各出発地と目的地間のルートであるため、要素数は出発地の数に目的地の数を掛けた値になります。たとえば、送信元が 10 個、宛先が 10 個ある場合、要素は 100 個になります。
TRANSITルート以外のルートの要素数は 625 個を超えることはできません。TRANSITルートを指定する場合、要素の数は 100 個以下にする必要があります。TRAFFIC_AWARE_OPTIMALを指定した場合、要素の数は 100 を超えることはできません。TRAFFIC_AWARE_OPTIMALの詳細については、トラフィック データを含める方法と含めるかどうかを指定するをご覧ください。住所または場所 ID を使用して出発地または目的地を指定する場合は、この方法で合計 50 件まで指定できます。
レスポンス エラー
Compute Route Matrix メソッドの特徴の 1 つは、レスポンス全体または個々のレスポンス要素に対してエラーを返すことができる点です。たとえば、リクエストの形式が正しくない場合（オリジンがゼロの場合など）、レスポンス全体にエラーが含まれます。
ただし、エラーがレスポンスの要素のサブセットに適用される場合（出発地と目的地の組み合わせでルートを計算できない場合など）、エラーの影響を受ける要素のみがエラーコードを返します。
gRPC ストリームの結果
ComputeRouteMatrix gRPC メソッドは、出発地と目的地のリストを受け取ると、出発地と目的地の組み合わせごとにルート情報を含んだストリームを返します。結果はストリームとして返されるため、すべてのルート組み合わせが計算されるまで待たずに、結果の処理を開始できます。
ストリームから返される要素が特定の順序で返される保証はありません。したがって、各レスポンス要素には origin_index と destination_index が含まれます。リクエストで指定された出発地と目的地の場合、ルートの出発地は特定の要素の origins[origin_index] に相当し、ルートの目的地は destinations[destination_index] に相当します。これらの配列はゼロ インデックスです。送信元と宛先のリスト順序を保存することが重要です。
ルート マトリックスの計算例
HTTP リクエストで computeRouteMatrix メソッドを使用して、ルート マトリックスを計算します。
HTTP の例
次の例は、computeRouteMatrix HTTP リクエストを示しています。この例では、次の操作を行います。
2 つの出発地ウェイポイントと 2 つの目的地ウェイポイントの配列を指定します。このメソッドは、各出発地から各目的地へのルートを計算するため、レスポンスには 4 つのルートが含まれます。
配列では、最初の要素はインデックス 0、2 番目の要素はインデックス 1 に存在します。以降の要素も同様に扱われます。
レスポンス フィールド マスクを含めて、返すレスポンス（REST）または ComputeRoutesResponse（gRPC）のフィールドを指定します。この例では、各ルートに対して
originIndex、destinationIndex、duration、distanceMeters、status、conditionを返すようにリクエストを構成します。詳細については、返されるフィールドを選択するをご覧ください。
curl -X POST -d '{
"origins": [
{
"waypoint": {
"location": {
"latLng": {
"latitude": 37.420761,
"longitude": -122.081356
}
}
},
"routeModifiers": { "avoid_ferries": true}
},
{
"waypoint": {
"location": {
"latLng": {
"latitude": 37.403184,
"longitude": -122.097371
}
}
},
"routeModifiers": { "avoid_ferries": true}
}
],
"destinations": [
{
"waypoint": {
"location": {
"latLng": {
"latitude": 37.420999,
"longitude": -122.086894
}
}
}
},
{
"waypoint": {
"location": {
"latLng": {
"latitude": 37.383047,
"longitude": -122.044651
}
}
}
}
],
"travelMode": "DRIVE",
"routingPreference": "TRAFFIC_AWARE"
}' \
-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'
レスポンスには、すべての出発地と目的地のウェイポイントを組み合わせた 4 つのルートが表示されます。
originIndex レスポンス フィールドと destinationIndex レスポンス フィールドを使用して、レスポンスの各ルートを特定します。たとえば、レスポンスの originIndex が 1 の場合、これはリクエストの origins 配列のインデックス 1 にあるウェイポイントから計算されたルートに相当します。
[
{
"originIndex": 0,
"destinationIndex": 0,
"status": {},
"distanceMeters": 822,
"duration": "160s",
"condition": "ROUTE_EXISTS"
},
{
"originIndex": 1,
"destinationIndex": 0,
"status": {},
"distanceMeters": 2919,
"duration": "361s",
"condition": "ROUTE_EXISTS"
},
{
"originIndex": 1,
"destinationIndex": 1,
"status": {},
"distanceMeters": 5598,
"duration": "402s",
"condition": "ROUTE_EXISTS"
},
{
"originIndex": 0,
"destinationIndex": 1,
"status": {},
"distanceMeters": 7259,
"duration": "712s",
"condition": "ROUTE_EXISTS"
}
]
gRPC の例
gRPC リクエストの例については、gRPC リクエストの例をご覧ください。そのページの Java の例では、Compute Routes と Compute Route Matrix の両方が呼び出されます。