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

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

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

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