דף זה תורגם על ידי Cloud Translation API.

ציון סוג מודל התנועה שבו יש להשתמש

מודלים של תנועה מתבססים על אלגוריתמים וגורמים ספציפיים כדי לחזות את האופן שבו התנועה התנאים משפיעים על זמן הנסיעה הכולל במסלול נתון. ממשק ה-API של Routes מציע סוגים שונים של מודלים של תנועה כדי לתת עדיפות לגורמים שונים שמשמשים חישוב משך הזמן בתנועה. אפשר לציין את סוג מודל התנועה כמו המסלולים שבהם משתמשים במהלך חישוב משך הזמן של המסלולים או המסלול במטריצה. כשמגדירים את סוג מודל התנועה, הערך המוחזר בפונקציה השדה duration משתנה בהתאם למודל התנועה שבוחרים.

גם ה-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 במסכת השדות.

REST

-H X-Goog-FieldMask: routes.duration

RPC

const (fieldMask = "routes.duration")

כשה-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, משך הזמן המוחזר הוא older:

"duration": "2436s"