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

欧州経済領域(EEA)のデベロッパー

選択した交通情報の設定により、ルートの詳細の精度とリクエストのパフォーマンスのバランスが次の 2 つの方法のいずれかで調整されます。

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

  • トラフィックを考慮しない - 結果をできるだけ早く(最小のレイテンシで)返します。

リクエストを行う際は、可能な限り正確な結果を返す方がよいか、可能な限り迅速に結果を返す方がよいかを検討してください。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: 過去の交通情報のみを考慮したルートの ETA。

出発時刻を設定する(省略可)

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

ルートを選択する際にサービスがトラフィックを予測する方法を調整する場合は、TRAFFIC_AWARE オプションおよび TRAFFIC_AWARE_OPTIMAL オプションとともに departureTime プロパティを使用します。

  • 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"
}