使用するトラフィック モデル タイプを指定する

トラフィック モデルでは、特定のアルゴリズムと要素を使用して、トラフィックがどのように変化するかを予測します。 特定のルートの合計移動時間に影響しますRoutes API さまざまなトラフィック モデルのタイプを提供し、トラフィック トラフィックで使用されるさまざまな要素に優先順位を付け 所要時間を計算していますトラフィック モデルのタイプを ルートやルートの所要時間を計算するときに使用するルートなど 表します。トラフィック モデル タイプを設定すると、 duration フィールドは、選択したトラフィック モデルによって異なります。

Routes API の Compute Routes と Compute Route Matrix メソッドは、トラフィック モデルタイプをサポートします。

デフォルトでは、どちらのメソッドも BEST_GUESS トラフィック モデルタイプを使用します。

トラフィック タイプを指定する

  1. 出発地と目的地を設定します。

  2. 出発時刻が将来の場合は、 departure_time パラメータ。出発時刻を指定しない場合は、 デフォルトは現在です

  3. trafficModel パラメータで使用するトラフィック モデルを選択します。 次のいずれかのタイプです。

    • BEST_GUESS（デフォルト）: 返された duration_in_traffic をリクエストする 両者についてわかっていることを考慮すると、移動時間は最も正確です。 リアルタイムの交通状況や現在の交通状況です。ライブ交通量の増加 departure_time が現在に近いほど重要です。デフォルトのタイプを使用する BEST_GUESS の大多数に対して最も有用な予測を 構築できます

    • PESSIMISTIC を使用して、返された duration_in_traffic でモデルをモデル化するようにリクエストします。 過去の交通状況から、悪天候の日に発生した交通状況を推定しています。 このタイプの推定所要時間は、次の値より長くなる可能性が高いです。 ほとんどの日の実際の移動時間です時折、特にエラーや この見積もりを超える可能性があります。

    • OPTIMISTIC を使用して、返された duration_in_traffic でモデルをモデル化するようにリクエストします。 過去の交通状況をもとに、良好な交通状況の曜日の時刻を計算します。 このタイプの予測時間は、より短い可能性が高い ほとんどの日の実際の移動時間です特に この推定値よりも高速になる場合があります。

    次に例を示します。

    "trafficModel": "OPTIMISTIC"

  4. フィールド マスクに routes.duration フィールドを指定します。

    REST

    -H X-Goog-FieldMask: routes.duration

    RPC

    const (fieldMask = "routes.duration")

Routes API は、交通状況を推定する際に、 モデルタイプを指定します

例: トラフィック モデルのリクエスト

たとえば、このリクエストでは、 特定の出発時刻の OPTIMISTIC 交通モデルタイプ:

curl -X POST -H 'content-type: application/json' -d ' {
"origin": {
  "address": "Kyoto, Japan"
  },
"destination": {
  "placeId": "ChIJrYtcv-urAWAR3XzWvXv8n_s"
  },
"travelMode": "DRIVE",
"routingPreference": "TRAFFIC_AWARE_OPTIMAL",
"trafficModel": "OPTIMISTIC"
}' \
-H 'Content-Type: application/json' \
-H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

このリクエストは、OPTIMISTIC トラフィック モデルを使用して推定所要時間を返します。 タイプ:

"duration": "1238s"

トラフィック モデルのタイプを PESSIMISTIC に変更すると、返される所要時間は次のようになります。 長め:

"duration": "2436s"