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)

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

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, המערכת תנסה להימנע מכבישי אגרה במקרים שבהם זה הגיוני, ותעדיף מסלולים שלא כוללים כבישי אגרה. ההנחה חלה רק על DRIVE ו-TWO_WHEELER TravelMode.
avoidHighways

boolean

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

boolean

זה שינוי אופציונלי. כשהערך מוגדר כ-true, המערכת תנסה להימנע ממעבורות במקרים שבהם זה אפשרי, ותעדיף מסלולים שלא כוללים מעבורות. ההנחה חלה רק על DRIVE ו-TWO_WHEELER TravelMode.
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 חישוב המסלולים תוך התחשבות בתנאי התנועה בזמן אמת, בלי להחיל את רוב האופטימיזציות לשיפור הביצועים. השימוש בערך הזה יוצר את זמן האחזור הגבוה ביותר.