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

מפתחים באזור הכלכלי האירופי (EEA)

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

משתמשים במאפיין routeModifiers בבקשה מהסוג RouteModifiers. אפשר לציין את הערכים avoidTolls,‏ avoidHighways,‏ avoidFerries ו-avoidIndoor.

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

בדוגמה הבאה אפשר לראות איך מגדירים משנים של מסלולים בגוף הבקשה של method ‏computeRoutes (REST). אפשר גם לציין את האפשרות הזו בשיטה ComputeRoutes ‏ (gRPC). בדוגמה הזו, מציינים להימנע מכבישי אגרה ומכבישים מהירים:

{
  "origin":{
    "location":{
      "latLng":{
        "latitude":37.419734,
        "longitude":-122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude":37.417670,
        "longitude":-122.079595
      }
    }
  },
  "routeModifiers": {
    "avoidTolls": true,
    "avoidHighways": true,
  }
}