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

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

גם השיטות Compute Routes של Routes API וגם Compute Route Matrix תומכות בסוגים של מודלים של תנועת גולשים.

כברירת מחדל, שתי השיטות משתמשות בסוג מודל התנועה BEST_GUESS.

כדי לציין סוג תנועה

  1. מגדירים את המוצא והיעד.

  2. אם שעת היציאה היא בעתיד, יש לכלול את השעה באמצעות הפרמטר departure_time. אם לא תציינו שעת יציאה, ברירת המחדל תהיה עכשיו.

  3. בוחרים את מודל התנועה לשימוש עם הפרמטר trafficModel ואחד מהסוגים הבאים:

    • BEST_GUESS (ברירת המחדל) כדי לבקש שה-duration_in_traffic שמוחזר הוא האומדן הטוב ביותר של זמן ההגעה, בהינתן המידע שידוע גם לגבי תנאי תנועה היסטוריים וגם תנועה בזמן אמת. התנועה בזמן אמת הופכת לחשובה יותר ככל שהכביש departure_time קרוב יותר להיום. שימוש בסוג ברירת המחדל BEST_GUESS מספק את החיזויים השימושיים ביותר ברוב התרחישים לדוגמה.

    • PESSIMISTIC כדי לבקש שהפונקציה duration_in_traffic שהוחזרה תבנה מודלים של הזמן על סמך מצב התנועה ההיסטורי בימים שבהם התנועה הייתה בעייתית. הסוג הזה מספק משך זמן משוער שסביר להניח שהוא ארוך יותר מזמן הנסיעה בפועל ברוב הימים. מדי פעם, ימים עם תנאים גרועים במיוחד עשויים לחרוג מהאומדן הזה.

    • OPTIMISTIC כדי לבקש שהפונקציה duration_in_traffic שהוחזרה תבנה מודלים של הזמן על סמך מצב התנועה ההיסטורי בימים שיש בהם תנועה טובה. הסוג הזה מספק משך זמן משוער בסבירות שהוא קצר יותר מזמן הנסיעה בפועל ברוב הימים. ימים מדי פעם עם תנאים טובים במיוחד עשויים להיות מהירים יותר מהאומדן הזה.

    לדוגמה:

    "trafficModel": "OPTIMISTIC"

  4. מציינים את השדה 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"