選択した交通状況の設定は、次のいずれかの方法で、ルートの詳細の精度とリクエストのパフォーマンスのバランスを取ります。
トラフィックを考慮 -- 可能な限り正確な結果を返します(レイテンシが高くなります)。
交通状況を考慮しない \-- できるだけ早く結果を返します(レイテンシが最も低くなります )。
リクエストを行う際は、可能な限り正確な結果を返す方がよいか、できるだけ早く結果を返す方がよいかを検討してください。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" }