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

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

هر دو متد Compute Routes Routes API و 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 را در ماسک فیلد مشخص کنید.

   استراحت

   -H X-Goog-FieldMask: routes.duration

   آر پی سی

   const (fieldMask = "routes.duration")

وقتی 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"