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

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

هذا المنتج أو هذه الميزة تجريبي (ما قبل التوفّر للجمهور العام). قد يتوفّر دعم محدود للمنتجات والميزات المتوفّرة في مرحلة ما قبل التوفّر للجمهور العام، وقد لا تتوافق التغييرات في المنتجات والميزات المتوفّرة في مرحلة ما قبل التوفّر للجمهور العام مع الإصدارات الأخرى المتاحة في مرحلة ما قبل التوفّر للجمهور العام. تخضع "عروض مرحلة ما قبل التوفّر للجمهور العام" للأحكام الخاصة بخدمة "منصة خرائط Google". لمزيد من المعلومات، يُرجى الاطّلاع على أوصاف مرحلة الإطلاق.

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