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

Routes API を使用して、computeRouteMatrix メソッド(REST)またはストリーミングの ComputeRouteMatrix メソッド(gRPC)を呼び出して、複数の出発地と目的地のルートの距離と所要時間を計算します。

このメソッドは、出発地と目的地のリストを基に、各出発地から各目的地までのルートの距離と所要時間を計算します。

交通機関のルートのマトリックスを取得する

交通機関のルート マトリックスを計算することもできます。例については、交通機関のルート マトリックスの取得をご覧ください。

リクエストに関する上限

Compute Route Matrix メソッドでは、住所または placeID を使用するウェイポイント、および要素に対して、次のリクエスト上限が適用されます。要素は、ルート マトリックス内の各出発地と目的地を結ぶルートであるため、要素の数は出発地の数に目的地の数を掛けた値になります。たとえば、出発地が 10 か所、目的地が 10 か所ある場合、100 個の要素が必要になります。

  • TRANSIT ルート以外のルートの場合、要素の数は 625 以下にする必要があります。

  • TRANSIT ルートを指定する場合、要素の数は 100 を超えることはできません。

  • TRAFFIC_AWARE_OPTIMAL を指定する場合、要素の数は 100 を超えることはできません。TRAFFIC_AWARE_OPTIMAL の詳細については、トラフィック データを含める方法と、含めるかどうかを指定するをご覧ください。

  • 住所やプレイス ID を使って出発地や目的地を指定する場合は、合計で 50 件まで指定できます。

レスポンス エラー

Compute Route Matrix メソッドの特長の 1 つは、レスポンス全体または個々のレスポンス要素に対してエラーを返すことができることです。たとえば、リクエストの形式が正しくない場合(オリジンがゼロなど)は、レスポンス全体にエラーが含まれます。

ただし、レスポンス内の要素のサブセットにエラーが適用される場合(たとえば、出発地と目的地の 1 つの組み合わせに対してルートを計算できない場合)、エラーの影響を受ける要素のみがエラーコードを返します。

gRPC ストリームの結果

ComputeRouteMatrix gRPC メソッドは、出発地と目的地のリストを受け取り、出発地と目的地の組み合わせごとにルート情報を含むストリームを返します。結果はストリームとして返されるため、可能なルートの組み合わせがすべて計算されるまで待たずに結果の処理を開始できます。

ストリームによって返される要素は、任意の順序で返されるとは限りません。したがって、各レスポンス要素には origin_indexdestination_index が含まれます。リクエストで指定された出発地と目的地については、特定の要素のルートの出発地は origins[origin_index] と同等で、ルートの目的地は destinations[destination_index] と同等です。これらの配列にはゼロのインデックスが付加されます。出発地と目的地のリストの注文を保存することが重要です。

ルート行列の計算例

HTTP リクエストで computeRouteMatrix メソッドを使用して、ルート マトリックスを計算します。

HTTP の例

次の例は、computeRouteMatrix HTTP リクエストを示しています。この例では、次のことを行います。

  • 出発地と目的地の 2 つのウェイポイントの配列を指定します。このメソッドは、各出発地から各目的地へのルートを計算し、レスポンスに 4 つのルートが含まれるようにします。

    この配列では、最初の要素のインデックスは 0、2 番目の要素はインデックス 1 のようになります。

  • レスポンス フィールド マスクを追加して、レスポンス(REST)または ComputeRoutesResponse(gRPC)のどのフィールドを返すかを指定します。この例では、ルートごとに originIndexdestinationIndexdurationdistanceMetersstatuscondition を返すようにリクエストを構成します。詳細については、返されるフィールドを選択するをご覧ください。

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 つのルートが含まれます。

originIndexdestinationIndex のレスポンス フィールドを使用して、レスポンスの各ルートを特定します。たとえば、レスポンスの 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 の両方を呼び出しています。