تستخدم نماذج حركة المرور خوارزميات وعوامل معينة للتنبؤ بكيفية تأثير ظروف حركة المرور على إجمالي وقت السفر لمسار معين. تقدّم Routes API أنواعًا مختلفة من نماذج الزيارات لتحديد الأولوية للعوامل المختلفة المستخدَمة في احتساب مدة حركة المرور. يمكنك تحديد نوع نموذج حركة المرور الذي تريد أن تستخدمه مساراتك عند حساب مدة مساراتك أو مصفوفة المسارات. عند ضبط نوع نموذج الزيارات، تختلف القيمة التي يتم عرضها في الحقل
duration
بناءً على نموذج الزيارات الذي تختاره.
تتوافق طريقتا Routes API Compute Routes
و
Compute Route Matrix
مع أنواع نماذج الزيارات.
تستخدِم كلتا الطريقتين نوع نموذج الزيارات BEST_GUESS
تلقائيًا.
لتحديد نوع زيارات
اضبط نقطة الانطلاق والوجهة.
إذا كان وقت المغادرة في المستقبل، أدرِج الوقت باستخدام معلَمة
departure_time
. إذا لم تحدد وقت المغادرة، يتم ضبطه بشكل افتراضي على الآن.اختَر نموذج الزيارات المطلوب استخدامه مع مَعلمة
trafficModel
وأحد الأنواع التالية:BEST_GUESS
(تلقائيًا) لطلب أن تكون قيمةduration_in_traffic
المعروضة هي أفضل تقدير لوقت الرحلة استنادًا إلى المعلومات المعروفة بكل من أحوال حركة المرور السابقة وحركة المرور المباشرة. تصبح حركة المرور في الوقت الفعلي أكثر أهمية مع اقتراب موعدdeparture_time
. يؤدي استخدام النوع التلقائي منBEST_GUESS
إلى الحصول على التوقعات الأكثر فائدة للغالبية العظمى من حالات الاستخدام.PESSIMISTIC
لطلب تحديد الوقت في نماذجduration_in_traffic
التي تم عرضها استنادًا إلى أحوال حركة المرور السابقة في أيام حركة المرور السيئة. يقدّم هذا النوع مدة مقدَّرة أطول من مدة السفر الفعلية في معظم الأيام. قد تظل الأيام من حين لآخر ذات ظروف سيئة بشكل خاص تتجاوز هذا التقدير.OPTIMISTIC
لطلب تحديد الوقت في نماذجduration_in_traffic
المعروضة استنادًا إلى أحوال حركة المرور السابقة في أيام حركة المرور الجيدة. يقدّم هذا النوع مدة تقديرية تكون على الأرجح أقصر من وقت السفر الفعلي في معظم الأيام. قد تكون الأيام من حين لآخر ذات ظروف جيدة بشكل خاص أسرع من هذا التقدير.
على سبيل المثال:
"trafficModel": "OPTIMISTIC"
حدِّد الحقل
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"