このページは Cloud Translation API によって翻訳されました。

ルートマトリックスを取得する

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 の両方が呼び出されます。