品質とレイテンシのトレードオフを構成する

Routes Preferred API では、ルートを計算するための 3 つのルート選択設定が用意されています。これらの設定は、ルートの計算に交通状況を考慮する程度が異なります。ルート選択設定ごとに、ルートの品質、推定到着時刻、レスポンス レイテンシが異なります。

交通状況について

交通状況は、交通の流れの速度を表します。次に例を示します。

  • 渋滞がない場合、交通状況は通常と見なされ、交通は通常の速度でスムーズに流れます。

  • ラッシュアワーが近づくと、交通密度が増加し、交通が減速し、交通状況が軽度から中程度になります。

  • 渋滞がひどい場合、交通の流れが完全に停止し、交通状況が非常に悪くなります。

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

TRAFFIC_UNAWARE ルート選択設定を設定すると、交通状況を考慮せずにルートが計算されます。このルート選択設定では、レスポンス レイテンシが最も低くなります（レスポンスが最も早く返されます）。

レスポンスをできるだけ早く返したい場合や、ルートの詳細が概算で十分な場合は、このルート選択設定を使用します。

トラフィックを考慮する

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

ルートの詳細をより正確にしたいが、レスポンスのレイテンシが中程度増加しても構わない場合は、このルート選択設定を使用します。

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

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

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

例

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

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