トラフィック モデルでは、特定のアルゴリズムと要素を使用して、トラフィックがどのように変化するかを予測します。
特定のルートの合計移動時間に影響しますRoutes API
さまざまなトラフィック モデルのタイプを提供し、キャンペーンで使用されるさまざまな要素に優先順位を付ける
所要時間を計算していますトラフィック モデルのタイプを
ルートやルートの所要時間を計算するときに使用するルートなど
表します。トラフィック モデル タイプを設定すると、
duration
フィールドは、選択したトラフィック モデルによって異なります。
Routes API の Compute Routes
メソッドと Compute Route Matrix
メソッドはどちらも、トラフィック モデルのタイプをサポートしています。
デフォルトでは、どちらのメソッドも BEST_GUESS
トラフィック モデルタイプを使用します。
トラフィック タイプを指定する
出発地と目的地を設定します。
出発時刻が将来の場合は、
departure_time
パラメータ。出発時刻を指定しない場合は、 デフォルトは現在ですtrafficModel
パラメータで使用するトラフィック モデルを選択します。 次のいずれかのタイプです。BEST_GUESS
(デフォルト): 過去と現在の交通状況のデータを基に見積もった最適な移動時間を、duration_in_traffic
で返すようリクエストします。ライブ交通量の増加departure_time
が現在に近いほど重要です。デフォルトのタイプを使用するBEST_GUESS
の大多数に対して最も有用な予測を 構築できますPESSIMISTIC
: 返されるduration_in_traffic
で、交通量の多い日の過去の交通状況に基づいて時間をモデル化するようリクエストします。このタイプの推定所要時間は、次の値より長くなる可能性が高いです。 ほとんどの日の実際の移動時間です時折、特にエラーや この見積もりを超える可能性があります。OPTIMISTIC
を使用して、返されたduration_in_traffic
でモデルをモデル化するようにリクエストします。 過去の交通状況をもとに、良好な交通状況の曜日の時刻を計算します。 このタイプの予測時間は、より短い可能性が高い ほとんどの日の実際の移動時間です特に この推定値よりも高速になる場合があります。
次に例を示します。
"trafficModel": "OPTIMISTIC"
フィールド マスクに
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"