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

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