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

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