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

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

تتوافق كلٌّ من طريقتَي Routes API Compute Routes و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 في قناع الحقول.

   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"