トラフィック データを含める方法と条件を指定する

選択した交通状況とルートの詳細の精度のバランス パフォーマンスが向上しますリクエストを行う際は、可能な限り正確な結果を返すのか、できるだけ早く結果を返すのか、どちらが優先されるかを検討する必要があります。Routes API には、レスポンス データの品質とレスポンスのレイテンシを制御できるオプションが用意されています。

交通データのレベルを設定

Routes API は RoutingPreference（REST）と RoutingPreference （gRPC）。ルート計算のルーティング設定を指定できます。これらの設定は、ルート計算に交通状況をどの程度考慮するかによって異なります。各ルーティング設定から生成される結果は、 ルートの質、推定到着予定時刻、応答レイテンシに関する度合い。

交通状況は交通量の比率を表します。例:

  • 渋滞がない場合、交通状況は正常と見なされ、交通は通常の速度で流れます。
  • ピーク時間に近づくとトラフィック密度が増加し、 軽めから中程度の渋滞が発生します。
  • バンパー間トラフィックでは、流量が減少して停止し、 表示されます。

トラフィック認識なし

TRAFFIC_UNAWARE ルーティング設定を設定すると、ルートが計算され、 現在の交通状況を考慮せずに 走行距離を計算できますこのルーティング設定では、レスポンス レイテンシが最も短くなります（レスポンスが最も速く返されます）。

TRAFFIC_UNAWARE がデフォルトの設定です。

レスポンスの説明:

  • 予定時刻は duration レスポンス プロパティに含まれています。

  • duration と staticDuration のレスポンス プロパティには、同じものが含まれます。 あります。

レスポンスの返信をできるだけ早く取得し、ルーティングの詳細が概略で十分な場合は、このルーティング設定を使用します。

交通状況を認識

TRAFFIC_AWARE ルーティング設定を設定すると、現在の交通状況を考慮してルート計算が行われます。そのため、ルートとルートは 実際の状況をより正確に反映しています。このデータ品質の向上はレスポンスのレイテンシを犠牲にするため、パフォーマンスの最適化が適用され、レイテンシの多くが削減されます。

レスポンスの説明:

  • リアルタイム トラフィックを考慮した ETA は、duration レスポンス プロパティに含まれます。

  • staticDuration レスポンス プロパティには、移動時間が含まれます。 通過するルートを選別します

このルーティング設定は、より正確なルーティングの詳細を TRAFFIC_UNAWARE であるとして、レスポンスが レイテンシが中程度に増加します。

トラフィック アウェア（最適化）

TRAFFIC_AWARE_OPTIMAL ルーティング設定を設定すると、ルートは 現在の交通状況を考慮して算出したが、パフォーマンスは 最適化が適用されますこのモードでは、サーバーが道路網をより徹底的に検索して最適なルートを検索します。

TRAFFIC_AWARE_OPTIMAL ルーティング設定は、 maps.google.com と Google マップ モバイルアプリ。

このオプションを Compute Route Matrix で使用する場合、 1 つのリクエストに含めることができる要素（出発地の数 × 目的地の数）は、 100。Compute Route Matrix の上限について詳しくは、以下をご覧ください。 ルート マトリックスを計算する。

レスポンスの説明:

  • リアルタイム トラフィックを考慮した ETA は、duration レスポンス プロパティに含まれます。

  • レスポンスの staticDuration プロパティには、交通状況を考慮しないルートの所要時間が含まれます。

このルーティング設定では、レスポンスのレイテンシが最も高くなります（つまり、 最長遅延時間でレスポンスが返されます）。レスポンスの所要時間に関係なく、最高品質の結果が必要な場合に、このルーティング設定を使用します。

出発時間の設定による影響

必要に応じて、departureTime プロパティを使用してルートの出発時間を設定します。departureTime プロパティを設定しない場合、デフォルトはリクエストを行った時刻になります。

  • TRAFFIC_UNAWARE では、departureTime を設定できません。次を選択しています。 ルートと所要時間は道路網に基づいており、時間に依存することなく 表示されます。

  • 「TRAFFIC_AWARE」と「TRAFFIC_AWARE_OPTIMAL」はライブ交通情報です ライブ交通情報の重要性が departureTimeが現在に近い状況です出発時間を先に設定するほど、過去の交通状況が重視されます。

ルーティング設定の例

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

ポリラインの交通情報を構成する

Routes API を使用すると、交通情報対応ポリラインに沿った交通状況に関する情報をリクエストできます。詳細については、ポリラインをリクエストするをご覧ください。