トラフィック データのレベルを設定する

欧州経済領域（EEA）のデベロッパー

選択した交通状況の設定は、次のいずれかの方法で、ルートの詳細の精度とリクエストのパフォーマンスのバランスを取ります。

  • トラフィックを考慮 -- 可能な限り正確な結果を返します（レイテンシが高くなります）。

  • 交通状況を考慮しない \-- できるだけ早く結果を返します（レイテンシが最も低くなります ）。

リクエストを行う際は、可能な限り正確な結果を返す方がよいか、できるだけ早く結果を返す方がよいかを検討してください。Routes API には、レスポンスのレイテンシとレスポンス データの品質を制御できるオプションが用意されています。

交通状況レベルを設定する方法

Routes API には、ルートの計算に使用するルーティング設定を指定できる RoutingPreference（REST）と RoutingPreference （gRPC）が用意されています。

デフォルトでは、交通状況を考慮しない結果が返されます。交通状況のオプションは、 TRAFFIC_UNAWARE、TRAFFIC_AWARE、TRAFFIC_AWARE_OPTIMAL のルーティング 設定で選択します。ルーティング設定ごとに、ルートの品質、到着予定時刻、レスポンスのレイテンシが異なります。

交通状況

交通状況は、交通の流れの速さを示します。

  • 通常の交通状況: 渋滞がなく、通常の速度で交通が流れています。

  • 軽度から中程度の交通状況: 渋滞が増加し、交通の流れが 遅くなっています。

  • 渋滞: 渋滞がひどく、交通速度が大幅に低下しています。

トラフィックを考慮しない

TRAFFIC_UNAWARE がデフォルトの設定です。レスポンスをできるだけ早く返したい場合や、おおよそのルートの詳細で十分な場合は、このルーティング設定を使用します。

TRAFFIC_UNAWARE ルートは、現在の交通状況を考慮せずに計算されます。このルーティング設定では、リクエストのレスポンスが最も速くなります（レイテンシが最も低くなります）。

TRAFFIC_UNAWARE を選択した場合、ルートと所要時間は、現在の交通状況ではなく、道路網と平均的な交通状況（時間的な要素を考慮に入れない）に基づいて選択されます。そのため、一時的に通行止めとなっている道路がルートに含まれることがあります。道路網における状況の変化、平均的な交通状況の最新情報、サービスの分散性などにより、リクエストの結果が時間の経過とともに変化する可能性があります。また、結果は、ほぼ同等のルートでも、時刻やリクエストの頻度によって異なる場合があります。

表示されるレスポンスは次のとおりです。

  • duration - ルートの到着予定時刻が含まれます。

  • staticDuration: 過去の交通情報のみを考慮したルートの到着予定時刻。TRAFFIC_UNAWARE の場合、duration と同じ値が含まれます。

交通状況を考慮

TRAFFIC_UNAWARE よりも正確なルートの詳細が必要で、レスポンスのレイテンシが多少増加しても問題ない場合は、このルーティング設定を使用します。

TRAFFIC_AWARE ルーティング設定を設定すると、現在の交通状況を考慮してルートが計算されます。その結果、ルートとルートの詳細が実際の状況をより正確に反映します。データ品質の向上はレスポンスのレイテンシの増加につながるため、パフォーマンスの最適化を適用してレイテンシを大幅に削減します。

表示されるレスポンスは次のとおりです。

  • duration: リアルタイムの交通情報を考慮した到着予定時刻。

  • staticDuration 過去の交通情報のみを考慮したルートの到着予定時刻。

交通状況を考慮した最適化

レスポンスに時間がかかってもかまわないので、最高品質の結果が必要な場合は、このルーティング設定を使用します。このルーティング設定では、レスポンスの返信に最も時間がかかります（レイテンシが最も高くなります）。

TRAFFIC_AWARE_OPTIMAL ルーティング設定を設定すると、現在の交通状況を考慮してルートが計算されますが、パフォーマンスの最適化は適用されません。このモードでは、サーバーは最適なルートを見つけるために、道路網のより徹底的な検索を実行します。

TRAFFIC_AWARE_OPTIMAL ルーティング設定は、 maps.google.com と Google マップ モバイルアプリで使用されるモードと同じです。

Compute Route Matrix でこのオプションを使用する場合、リクエスト内の要素数（出発地の数 × 目的地の数）には上限があります。 Compute Route Matrix の上限について詳しくは、ルート マトリックスを計算するをご覧ください。

表示されるレスポンスは次のとおりです。

  • duration: リアルタイムの交通情報を考慮したルートの到着予定時刻。

  • staticDuration: 過去の交通情報のみを考慮したルートの到着予定時刻。

出発時刻を設定する（省略可）

このプロパティは、出発時刻を将来にする必要がある交通状況を考慮したリクエストにのみ使用してください。departureTime プロパティを設定しない場合、デフォルトではリクエストを行った時刻が使用されます。

ルートを選択する際に、サービスの交通状況の予測方法を調整する場合は、departureTime プロパティを TRAFFIC_AWARE オプションと TRAFFIC_AWARE_OPTIMAL オプションとともに使用します。

  • TRAFFIC_UNAWARE: ルートと所要時間は道路網と平均的な交通状況（時間的な要素を考慮に入れない）に基づいて選択されるため、おすすめしません 。

  • TRAFFIC_AWARE と TRAFFIC_AWARE_OPTIMAL: 近い将来に出発する場合におすすめ します。これらの 設定ではリアルタイム交通状況が考慮されるためです。departureTime が現在時刻に近いほど、リアルタイム交通情報がより重要かつ関連性の高いものになります。出発時刻を将来に設定するほど、ルートの選択において過去の交通状況が考慮されます。

例: 交通状況を考慮したルーティングを選択する方法

次の JSON コードは、リクエスト メッセージ エンティティ本文で TRAFFIC_AWARE_OPTIMAL ルーティング設定を設定する方法を示しています。

{
  "origin":{
    "location":{
      "latLng":{
        "latitude":37.419734,
        "longitude":-122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":37.417670,
        "longitude":-122.079595
      }
    }
  },
  "travelMode":"DRIVE",
  "routingPreference":"TRAFFIC_AWARE_OPTIMAL"
}

ポリラインの交通状況を構成する

Routes API を使用すると、交通状況を考慮したポリラインに沿った交通状況に関する情報をリクエストできます。 詳しくは、 ポリラインをリクエストするをご覧ください。