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

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

   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"