تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

تستخدم نماذج حركة المرور خوارزميات وعوامل محددة للتنبؤ بكيفية تأثير ظروف حركة المرور في إجمالي وقت السفر لمسار معين. توفر 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"
```
ملاحظة: من الممكن أن يكون توقّع مدة الرحلة BEST_GUESS أقصر من OPTIMISTIC أو أطول من PESSIMISTIC، بسبب الطريقة التي يدمج بها BEST_GUESS معلومات حركة المرور المباشرة.
حدِّد الحقل routes.duration في قناع الحقل.

وقت الراحة
```
-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"