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

المطوّرون في المنطقة الاقتصادية الأوروبية

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

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

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