מודלים של תנועה משתמשים באלגוריתמים ובגורמים ספציפיים כדי לחזות איך תנאי התנועה משפיעים על זמן הנסיעה הכולל במסלול נתון. ב-Routes API יש סוגים שונים של מודלים של תעבורת נתונים, כדי לתת עדיפות לגורמים שונים שמשמשים לחישוב משך התנועה. ניתן לציין את סוג מודל התנועה שבו רוצים להשתמש במסלולים, בחישוב משך הזמן של המסלולים או של מטריצת המסלולים. כשמגדירים את הסוג של מודל התנועה, הערך שהוחזר בשדה duration
משתנה בהתאם למודל התנועה שבחרתם.
גם השיטות Compute Routes
של Routes API וגם 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"
מציינים את השדה
routes.duration
באנונימיזציה של השדות.REST
-H X-Goog-FieldMask: routes.duration
RPC
const (fieldMask = "routes.duration")
כשה-API של 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"