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

تستخدِم نماذج حركة المرور خوارزميات وعوامل محدّدة لتوقّع مدى تأثير تضاؤل كثافة حركة المرور في إجمالي وقت التنقّل على مسار معيّن. تقدّم واجهة برمجة التطبيقات Routes API أنواعًا مختلفة من نماذج الزيارات لمنح الأولوية للعوامل المختلفة المستخدَمة في محاسبة المدّة في الزيارات. يمكنك تحديد نوع نموذج حركة المرور الذي تريد أن تستخدِمه طرقك عند احتساب مدة طرقك أو ملف تعريف المسار. عند ضبط نوع نموذج الزيارات، تختلف القيمة المعروضة في حقل 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"