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

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

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

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

リクエストを行う際は、できるだけ正確な結果を返すのか、できるだけ早く結果を返すのか、どちらが優先されるかを検討してください。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 でこのオプションを使用する場合、リクエスト内の要素数（出発地の数 × 目的地の数）は次の上限を超えることはできません。

  1. 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 を使用すると、交通情報対応ポリラインに沿った交通状況に関する情報をリクエストできます。詳細については、ポリラインをリクエストするをご覧ください。