تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

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

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

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

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

بشكلٍ تلقائي، تستخدم كلتا الطريقتَين نوع نموذج الزيارات BEST_GUESS.

لتحديد نوع الزيارات

حدِّد نقطة الانطلاق والوجهة.
إذا كان وقت المغادرة في المستقبل، أدرِج الوقت باستخدام المَعلمة departure_time. إذا لم تحدّد وقت المغادرة، سيتم تلقائيًا ضبطه على الوقت الحالي.
اضبط المَعلمة routingPreference على TRAFFIC_AWARE_OPTIMAL. لا يتوافق ضبط routingPreference على TRAFFIC_UNAWARE أو TRAFFIC_AWARE مع المَعلمة trafficModel.
اختَر نموذج الزيارات الذي تريد استخدامه مع المَعلمة 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 في قناع الحقل.

REST
```
-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"

تحديد نوع نموذج الزيارات المطلوب استخدامه تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

لتحديد نوع الزيارات

مثال: طلب نموذج حركة المرور

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