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

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

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

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