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

選択した交通状況の優先度によって、ルートの詳細の精度とリクエストのパフォーマンスのバランスが次のいずれかの方法で調整されます。

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

• トラフィック アウェアなし - 結果をできるだけ早く返します（レイテンシが最小）。

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

トラフィック レベルを設定する方法

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

デフォルトは、トラフィックを認識しない結果です。トラフィック オプションは、TRAFFIC_UNAWARE、TRAFFIC_AWARE、TRAFFIC_AWARE_OPTIMAL のルーティング設定で選択します。ルーティング設定ごとに、ルートの品質、推定 ETA、レスポンス レイテンシが異なる結果が生成されます。

交通状況

交通状況は、トラフィック フローのレートを表します。

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

• 渋滞気味: 渋滞がひどくなり、交通の流れが遅くなっています。

• 渋滞: 交通速度が大幅に低下している、深刻な渋滞。

交通状況を認識していない

デフォルトの設定は TRAFFIC_UNAWARE です。このルーティング設定は、最も迅速なレスポンスを必要とし、おおよそのルーティングの詳細で十分な場合に適しています。

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

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

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

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

• staticDuration: 過去の交通情報のみを考慮したルートの ETA。TRAFFIC_UNAWARE には、duration と同じ値が含まれます。

交通状況を認識する

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

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

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

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

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

トラフィック アウェア オプティマル

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

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

TRAFFIC_AWARE_OPTIMAL ルート選択は、maps.google.com と Google マップ モバイルアプリで使用されるモードと同等です。

このオプションを Compute Route Matrix で使用する場合、リクエスト内の要素数（出発地の数 × 目的地の数）は

1. Compute Route Matrix の制限の詳細については、ルート マトリックスを計算するをご覧ください。

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

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

• staticDuration: 過去の交通情報のみを考慮したルートの ETA。

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

このプロパティは、出発時刻を将来の日時にする必要がある交通状況認識リクエストでのみ使用します。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 を使用すると、交通状況を考慮したポリラインに沿った交通状況に関する情報をリクエストできます。詳細については、ポリラインをリクエストするをご覧ください。