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

‫Routes Preferred 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"
}