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

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