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

تستخدم نماذج حركة المرور خوارزميات وعوامل معيّنة لتوقُّع تأثير أحوال حركة المرور في إجمالي مدة الرحلة على مسار معيّن. توفّر 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"