הגדרת הפשרה של איכות לעומת זמן אחזור

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

מידע על מצב התנועה

מצב התנועה מאפיין את קצב התנועה. לדוגמה:

• כשאין עומס תנועה, תנאי התנועה נחשבים לרגילים והתנועה זורמת במהירות הרגילה ללא הפרעה.

• לקראת שעת העומס, צפיפות התנועה עולה, מה שגורם להאטה של התנועה ומייצר תנאי תנועה קלים עד בינוניים.

• במצב של תנועה צפופה, קצב התנועה נעצר, וכתוצאה מכך יש עומס כבד.

תנועה לא מודעת

כשמגדירים את העדפת הניתוב TRAFFIC_UNAWARE, המסלולים מחושבים בלי להביא בחשבון את תנאי התנועה. העדפת הניתוב הזו מספקת את זמן האחזור הקצר ביותר לתגובה (התשובות מוחזרות במהירות הרבה ביותר).

כדאי להשתמש בהעדפת הניתוב הזו כשרוצים לקבל תשובות מהר ככל האפשר, ופרטי הניתוב המשוערים מספיק טובים.

התראות על מצב התנועה

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

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

אופטימלי עם התחשבות בתנועה

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

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

דוגמה

קוד ה-JSON הבא מדגים איך מגדירים את העדפת הניתוב בגוף הישות של הודעת הבקשה.

{
  "origin":{
    "location":{
      "latLng":{
        "latitude":37.419734,
        "longitude":-122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":37.417670,
        "longitude":-122.079595
      }
    }
  },
  "travelMode":"DRIVE",
  "routingPreference":"TRAFFIC_AWARE_OPTIMAL"
}