تحديد نوع نموذج الزيارات المطلوب استخدامه

تستخدم نماذج حركة المرور خوارزميات وعوامل معينة للتنبؤ بكيفية تأثير ظروف حركة المرور على إجمالي مدة السفر لمسار معين. تقدّم واجهة برمجة التطبيقات Routes API أنواعًا مختلفة من نماذج الزيارات لمنح الأولوية للعوامل المختلفة المستخدَمة في calculation duration in traffic. يمكنك تحديد نوع نموذج حركة المرور الذي تريد أن تستخدِمه طرقك عند احتساب مدة طرقك أو ملف مسار التنقّل. عند ضبط نوع نموذج الزيارات، تختلف القيمة المعروضة في حقل duration استنادًا إلى نموذج الزيارات الذي تختاره.

تتيح كلتا الطريقتَين Compute Routes و Compute Route Matrix في Routes API أنواع نماذج حركة المرور.

تستخدِم كلتا الطريقتَين تلقائيًا نوع نموذج 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"