RoutingParameters

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

ייצוג JSON 
{
  "origin": {
    object (LatLng)
  },
  "travelMode": enum (TravelMode),
  "routeModifiers": {
    object (RouteModifiers)
  },
  "routingPreference": enum (RoutingPreference)
}
שדות
origin

object (LatLng)

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

enum (TravelMode)

זה שינוי אופציונלי. מצב הנסיעה.
routeModifiers

object (RouteModifiers)

זה שינוי אופציונלי. מקשי הצירוף של המסלול.
routingPreference

enum (RoutingPreference)

זה שינוי אופציונלי. מציינת איך לחשב את סיכום הניתוב. השרת מנסה להשתמש בעדיפות הניתוב שנבחרה כדי לחשב את המסלול. העדפה של 'תכנון מסלול עם בקרת תנועה' זמינה רק עבור travelMode מסוג DRIVE או TWO_WHEELER.

TravelMode

אפשרויות של מצב נסיעה. האפשרויות האלה מבוססות על Routes API.

טיפוסים בני מנייה (enum)
TRAVEL_MODE_UNSPECIFIED לא צוין מצב נסיעה. ברירת המחדל היא DRIVE.
DRIVE נסיעה במכונית פרטית.
BICYCLE נסיעה באופניים. אין תמיכה ב-searchAlongRouteParameters.
WALK נסיעה בהליכה. לא נתמך ב-searchAlongRouteParameters.
TWO_WHEELER כלי רכב דו-גלגליים ממונעים מכל הסוגים, כמו קורקינטים ואופנועים. הערה: האפשרות הזו שונה מאמצעי התחבורה BICYCLE, שמכסה את אמצעי התחבורה האנושית. אין תמיכה ב-searchAlongRouteParameters. התכונה נתמכת רק במדינות שמפורטות במדינות ובאזורים שנתמכים בכלי רכב דו-גלגליים.

RouteModifiers

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

ייצוג JSON 
{
  "avoidTolls": boolean,
  "avoidHighways": boolean,
  "avoidFerries": boolean,
  "avoidIndoor": boolean
}
שדות
avoidTolls

boolean

זה שינוי אופציונלי. כשהערך מוגדר כ-true, המערכת תנסה להימנע מכבישי אגרה במקרים שבהם זה הגיוני, ותעדיף מסלולים שלא כוללים כבישי אגרה. רלוונטי רק לTravelMode DRIVE ולTWO_WHEELER.
avoidHighways

boolean

זה שינוי אופציונלי. אם המדיניות מוגדרת כ-True, היא נמנעת מכבישים מהירים במידת הסבירות, ומעניקה עדיפות למסלולים שאינם מכילים כבישים מהירים. ההנחה חלה רק על DRIVE ו-TWO_WHEELER TravelMode.
avoidFerries

boolean

זה שינוי אופציונלי. אם המדיניות מוגדרת כ-True, היא נמנעת ממעבורות במקומות שבהם היא סבירה, ומעניקה עדיפות למסלולים שאינם מכילים מעבורות. רלוונטי רק לTravelMode DRIVE ולTWO_WHEELER.
avoidIndoor

boolean

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

RoutingPreference

קבוצת ערכים שמציינים גורמים שצריך להביא בחשבון בעת חישוב המסלול.

טיפוסים בני מנייה (enum)
ROUTING_PREFERENCE_UNSPECIFIED לא צוינה העדפת ניתוב. ברירת המחדל היא TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE מחשב את המסלולים בלי להביא בחשבון את מצב התנועה בזמן אמת. מתאים למקרים שבהם מצב התנועה לא רלוונטי או לא חשוב. השימוש בערך הזה מספק את זמן האחזור הנמוך ביותר. הערה: בTravelMode DRIVE וTWO_WHEELER, המסלול ומשך הזמן שנבחרו מבוססים על רשת הכבישים ועל תנאי התנועה שתלויים בזמן הממוצע, ולא בתנאי הכביש הנוכחיים. כתוצאה מכך, המסלולים עשויים לכלול כבישים שסגורים באופן זמני. התוצאות של בקשה מסוימת עשויות להשתנות עם הזמן, עקב שינויים ברשת הכבישים, עדכון תנאי התנועה הממוצעים ואופי המבוזר של השירות. התוצאות יכולות גם להשתנות בין מסלולים כמעט זהים בכל שלב או בתדירות גבוהה.
TRAFFIC_AWARE מחשבת מסלולים תוך התחשבות בתנאי התנועה בזמן אמת. בניגוד ל-TRAFFIC_AWARE_OPTIMAL, חלק מהאופטימיזציות יושמו כדי לצמצם באופן משמעותי את זמן האחזור.
TRAFFIC_AWARE_OPTIMAL מחשבת את המסלולים תוך התחשבות בתנאי התנועה בזמן אמת, בלי להחיל את רוב פעולות האופטימיזציה של הביצועים. השימוש בערך הזה יוצר את זמן האחזור הגבוה ביותר.