نوع مدل ترافیک مورد استفاده را مشخص کنید

مدل‌های ترافیک از الگوریتم‌ها و عوامل خاصی برای پیش‌بینی اینکه چگونه شرایط ترافیکی بر زمان کل سفر برای یک مسیر معین تأثیر می‌گذارد، استفاده می‌کنند. Routes API انواع مدل های ترافیکی مختلفی را برای اولویت بندی عوامل مختلف مورد استفاده در محاسبه مدت زمان در ترافیک ارائه می دهد. می‌توانید نوع مدل ترافیکی را که می‌خواهید مسیرهایتان هنگام محاسبه مدت زمان مسیرها یا ماتریس مسیرتان استفاده کنند، مشخص کنید. وقتی نوع مدل ترافیک را تنظیم می کنید، مقدار بازگشتی در قسمت duration بسته به مدل ترافیکی که انتخاب می کنید متفاوت است.

هر دو روش Routes API Compute Routes و Compute Route Matrix از انواع مدل ترافیک پشتیبانی می کنند.

به طور پیش فرض، هر دو روش از نوع مدل ترافیک BEST_GUESS استفاده می کنند.

برای تعیین نوع ترافیک

1. مبدا و مقصد خود را تعیین کنید.

2. اگر زمان حرکت شما در آینده است، زمان را با استفاده از پارامتر departure_time درج کنید. اگر زمان حرکت را مشخص نکنید، به طور پیش‌فرض روی هم‌اکنون تنظیم می‌شود.

3. پارامتر routingPreference را روی TRAFFIC_AWARE_OPTIMAL تنظیم کنید. تنظیم routingPreference روی TRAFFIC_UNAWARE یا TRAFFIC_AWARE با پارامتر trafficModel ناسازگار است.

4. مدل ترافیک را برای استفاده با پارامتر trafficModel و یکی از انواع زیر انتخاب کنید:

   • BEST_GUESS (پیش‌فرض) برای درخواست این که duration_in_traffic برگشتی بهترین تخمین زمان سفر با توجه به آنچه در مورد شرایط ترافیک تاریخی و ترافیک زنده شناخته شده است، باشد. هرچه زمان departure_time به زمان کنونی نزدیک‌تر باشد، ترافیک زنده اهمیت بیشتری پیدا می‌کند. استفاده از نوع پیش‌فرض BEST_GUESS مفیدترین پیش‌بینی‌ها را برای اکثر موارد استفاده می‌دهد.

   • PESSIMISTIC درخواست کند که duration_in_traffic برگشتی زمان را بر اساس شرایط ترافیکی تاریخی در روزهای بد ترافیک مدل کند. این نوع مدت زمان تخمینی را نشان می دهد که به احتمال زیاد بیشتر از زمان واقعی سفر در بیشتر روزها است. روزهای گاه به گاه با شرایط خاص بد ممکن است همچنان از این تخمین بیشتر باشد.

   • OPTIMISTIC درخواست کند که duration_in_traffic برگشتی زمان را بر اساس شرایط ترافیکی تاریخی در روزهای خوب ترافیک مدل کند. این نوع مدت زمان تخمینی را نشان می دهد که به احتمال زیاد کمتر از زمان واقعی سفر در بیشتر روزها است. روزهای گاه به گاه با شرایط به خصوص خوب ممکن است همچنان سریعتر از این تخمین باشند.

   به عنوان مثال:

   "trafficModel": "OPTIMISTIC"

5. فیلد routes.duration را در قسمت mask مشخص کنید.

   استراحت

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