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

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

   وقت الاستراحة

   -H X-Goog-FieldMask: routes.duration

   متوسط عائد النقرة

   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"