Route

מחלקה Route

מחלקה google.maps.routes.Route

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

כדי לקבל גישה, צריך לקרוא ל: const {Route} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

computeRoutes
computeRoutes(request)
פרמטרים: 
ערך מוחזר:  Promise<{
  routes:Array<Route> optional,
  fallbackInfo:FallbackInfo optional,
  geocodingResults:GeocodingResults optional
}>
הפונקציה מחזירה את המסלול הראשי יחד עם מסלולים חלופיים אופציונליים, בהינתן קבוצה של נקודות ציון סופיות ונקודות ציון ביניים.

הערה: בשיטה הזו צריך לציין מסכת שדה תגובה בבקשה על ידי הגדרת המאפיין ComputeRoutesRequest.fields. הערך הוא רשימה של נתיבי שדות.

לדוגמה:
  • אנונימיזציה של כל השדות הזמינים: fields: ['*']
  • אנונימיזציה של שדות למשך, למרחק ולנתיב ברמת המסלול: fields: ['durationMillis', 'distanceMeters', 'path']

לא מומלץ להשתמש באנונימיזציה של שדות בתגובה עם תו כללי לחיפוש fields: ['*'] כי:
  • אם תבחרו רק את השדות שאתם צריכים, השרת שלנו יחסוך מחזורי חישוב, וכך נוכל להחזיר לכם את התוצאה עם זמן אחזור קצר יותר.
  • כדי להבטיח ביצועי זמן אחזור יציבים, בחרו רק את השדות שאתם צריכים במשימת הייצור. יכול להיות שנוסיף עוד שדות תגובה בעתיד, והשדות החדשים האלה עשויים לדרוש זמן חישוב נוסף. אם תבחרו את כל השדות, או את כל השדות ברמה העליונה, יכול להיות שתהיה ירידה בביצועים כי כל שדה חדש שנוסיף ייכלל באופן אוטומטי בתגובה.
  • אם תבחרו רק את השדות שאתם צריכים, התגובה תהיה קטנה יותר, ולכן היא תיטען מהר יותר ברשת.
description
סוג:  string optional
תיאור של המסלול.
distanceMeters
סוג:  number optional
מרחק הנסיעה של המסלול, במטרים.
durationMillis
סוג:  number optional
משך הזמן שנדרש כדי לנווט במסלול, באלפיות השנייה. אם מגדירים את ComputeRoutesRequest.routingPreference כ-TRAFFIC_UNAWARE, הערך הזה זהה ל-Route.staticDurationMillis. אם מגדירים את ComputeRoutesRequest.routingPreference לערך TRAFFIC_AWARE או TRAFFIC_AWARE_OPTIMAL, הערך הזה מחושב תוך התחשבות במצב התנועה.

הערה: אם משך הזמן חורג מ-‎2^53 אלפיות השנייה, הערך הזה הוא Number.POSITIVE_INFINITY.
legs
סוג:  Array<RouteLeg> optional
אוסף של מקטעים (קטעי מסלול בין נקודות ציון) שמרכיבים את המסלול. כל קטע תואם לנסיעה בין שתי נקודות ציון שאינן via.

לדוגמה:
  • במסלול בלי נקודות ציון ביניים יש רק מקטע אחד.
  • במסלול שכולל נקודת ציון אחת שהיא לא via יש שני מקטעים.
  • מסלול שכולל נקודת ציון אחת (via) באמצע הדרך מכיל מקטע אחד.
סדר המקטעים תואם לסדר של נקודות הדרך מ-origin אל intermediates ואז אל destination.
localizedValues
סוג:  RouteLocalizedValues optional
ייצוגים בטקסט של מאפייני Route.
optimizedIntermediateWaypointIndices
סוג:  Array<number> optional
אם מגדירים את ComputeRoutesRequest.optimizeWaypointOrder לערך true, השדה הזה מכיל את הסדר האופטימלי של ציוני הדרך. אחרת, השדה הזה ריק. האינדקס מתחיל ב-0 עבור נקודת הביניים הראשונה שצוינה בקלט.

לדוגמה, אם הקלט הוא:
  • מקור: לוס אנג'לס
  • נקודות ביניים: דאלאס, בנגור, פיניקס
  • יעד: ניו יורק
והסדר האופטימלי של נקודות הציון הוא פיניקס, דאלאס, בנגור, השדה הזה יהיה [2, 0, 1].
path
סוג:  Array<LatLngAltitude> optional
רשימת ה-LatLngAltitude של המסלול, שבה אפשר להשתמש כדי לשרטט קו פוליגוני של המסלול. אפשר לשלוט ברמת הפירוט של הנתיב באמצעות ההגדרה ComputeRoutesRequest.polylineQuality.
polylineDetails
סוג:  PolylineDetails optional
מכיל מידע על פרטים לאורך המסלול.
routeLabels
סוג:  Array<RouteLabel> optional
תוויות למסלול שמועילות לזיהוי מאפיינים ספציפיים או להשוואה בין מסלולים.
routeToken
סוג:  string optional
אסימון אטום שאפשר להעביר ל-Navigation SDK כדי לשחזר את המסלול במהלך הניווט, ובמקרה של שינוי מסלול, לכבד את הכוונה המקורית כשהמסלול נוצר. התייחסו לטוקן הזה כאל אובייקט BLOB אטום. אל תשוו את הערך שלו בין בקשות, כי הערך עשוי להשתנות גם אם השירות מחזיר בדיוק את אותו מסלול.

הערה: routeToken זמין רק לבקשות שבהן ComputeRoutesRequest.routingPreference מוגדר ל-TRAFFIC_AWARE או ל-TRAFFIC_AWARE_OPTIMAL. הוא לא נתמך בבקשות עם via נקודות ציון.
speedPaths
סוג:  Array<SpeedPath> optional
קבוצות של קטעים בנתיב המסלול עם קריאת המהירות המתאימה להם. כדי שהשדה הזה יאוכלס, צריך להגדיר את ComputeRoutesRequest.routingPreference ל-TRAFFIC_AWARE או ל-TRAFFIC_AWARE_OPTIMAL, ו-ComputeRoutesRequest.extraComputations צריך לכלול את TRAFFIC_ON_POLYLINE.
staticDurationMillis
סוג:  number optional
משך הנסיעה במסלול בלי להביא בחשבון את מצב התנועה.

הערה: אם משך הזמן חורג מ-‎2^53 אלפיות השנייה, הערך הזה הוא Number.POSITIVE_INFINITY.
travelAdvisory
סוג:  RouteTravelAdvisory optional
מידע נוסף על המסלול.
viewport
סוג:  LatLngBounds optional
התיבה התוחמת של אזור התצוגה של המסלול.
warnings
סוג:  Array<string> optional
מערך של אזהרות שיוצגו כשמציגים את המסלול.
createPolylines
createPolylines([options])
פרמטרים: 
ערך מוחזר:  Array<Polyline>
יצירת קווים פוליגוניים למסלול על סמך הנתונים הזמינים.

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

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

קו פוליגוני כולל:
  • דרישות:
  • יוצר קו פוליגוני אחד לכל המסלול עם סגנון ברירת המחדל. אפשר להעביר אפשרויות כדי לשנות את הסגנון של הקו הפוליגוני בהתאם לאמצעי התחבורה במסלול. כדי להתאים אישית את הקווים הפוליגוניים, אפשר ליצור אותם ישירות באמצעות Route.path או RouteLeg.path.
createWaypointAdvancedMarkers
createWaypointAdvancedMarkers([options])
ערך מוחזר:  Promise<Array<AdvancedMarkerElement>>
יוצרת סמנים למסלול עם התוויות 'A',‏ 'B',‏ 'C' וכו' לכל נקודת דרך. לסמנים יש סגנון ברירת מחדל. אפשר להעביר אפשרויות כדי לשנות את סגנון הסמן על סמך האינדקס של הסמן או המאפיינים של ה-RouteLeg התואם. הפרמטר WaypointMarkerDetails.leg לא יהיה מוגדר אם למסלול אין מקטעים.

צריך לבקש את השדה "legs" ב-ComputeRoutesRequest.fields כדי לכלול נקודות ציון ביניים.
toJSON
toJSON()
פרמטרים:  אין
ערך מוחזר:  Object
המרת הנתונים לאובייקט.

ממשק ComputeRoutesRequest

ממשק google.maps.routes.ComputeRoutesRequest

בקשה למסלולים.

destination
היעד של המסלול. ערך שמועבר כמחרוזת יכול להיות כתובת, Plus Code או שם של משאב מקום. ערכי הגובה לא נלקחים בחשבון בחישוב המסלולים.
fields
סוג:  Iterable<string>
אוסף של שדות לאחזור. מציינים ["*"] בכל השדות.
origin
נקודת המוצא של המסלול. ערך שמועבר כמחרוזת יכול להיות כתובת, Plus Code או שם של משאב מקום. ערכי הגובה לא נלקחים בחשבון בחישוב המסלולים.
arrivalTime optional
סוג:  Date optional
זמן ההגעה.

הערה: אפשר להגדיר את המדיניות הזו רק אם המדיניות ComputeRoutesRequest.travelMode מוגדרת לערך TRANSIT. אפשר לציין את ComputeRoutesRequest.departureTime או את ComputeRoutesRequest.arrivalTime, אבל לא את שניהם. אפשר לראות נסיעות בתחבורה ציבורית עד 7 ימים בעבר או עד 100 ימים בעתיד.
computeAlternativeRoutes optional
סוג:  boolean optional
מציין אם לחשב מסלולים חלופיים בנוסף למסלול. לא מוחזרים מסלולים חלופיים לבקשות שיש בהן נקודות ביניים.
departureTime optional
סוג:  Date optional
שעת היציאה. אם לא תגדירו את הערך הזה, המערכת תשתמש כברירת מחדל בחותמת הזמן של הבקשה.

הערה: אפשר לציין זמן בעבר רק כשמגדירים את ComputeRoutesRequest.travelMode כ-TRANSIT. אפשר לראות נסיעות בתחבורה ציבורית עד 7 ימים בעבר או עד 100 ימים בעתיד.
extraComputations optional
רשימה של חישובים נוספים שאפשר להשתמש בהם כדי להשלים את הבקשה.

הערה: החישובים הנוספים האלה עשויים להחזיר שדות נוספים בתגובה. כדי שהשדות הנוספים האלה יוחזרו בתגובה, צריך לציין אותם גם ב-ComputeRoutesRequest.fields.
intermediates optional
סוג:  Iterable<Waypoint> optional
קבוצה של נקודות ציון לאורך המסלול (לא כולל נקודות קצה), לעצירה או למעבר. אפשר להוסיף עד 25 נקודות ציון ביניים.
language optional
סוג:  string optional
קוד השפה בתקן BCP-47, למשל "en-US" או "sr-Latn". מידע נוסף זמין במאמר מזהה לוקאל של Unicode. כאן מפורטות השפות שבהן אפשר לקבל תמיכה. אם לא תציינו את הערך הזה, השפה תוסק מהגדרות הלוקליזציה של Google Maps JavaScript API. אחרת, השפה נקבעת לפי המיקום של המקור.
optimizeWaypointOrder optional
סוג:  boolean optional
אם הערך הוא true, השירות מנסה לצמצם את העלות הכוללת של המסלול על ידי שינוי הסדר של נקודות הדרך שצוינו. הבקשה נכשלת אם אחת מנקודות הדרך היא נקודת מעבר. משתמשים ב-Route.optimizedIntermediateWaypointIndices בתשובה כדי למצוא את הסדר החדש. אם לא מבקשים את "optimizedIntermediateWaypointIndices" ב-ComputeRoutesRequest.fields, הבקשה נכשלת. אם המדיניות מוגדרת כ-False, השדה Route.optimizedIntermediateWaypointIndices בתגובה יהיה ריק.
polylineQuality optional
סוג:  PolylineQuality optional
מציינת את ההעדפה לאיכות הקו הפוליגוני.
region optional
סוג:  string optional
קוד האזור, שמוגדר כערך ccTLD (דומיין ברמה העליונה) באורך שני תווים. מידע נוסף זמין במאמר דומיינים ברמה העליונה עם קוד מדינה (ccTLD). אם לא תספקו את הערך הזה, האזור יוסק מהגדרות הלוקליזציה של Google Maps JavaScript API. אחרת, האזור נקבע לפי המיקום של המקור.
requestedReferenceRoutes optional
סוג:  Iterable<ReferenceRoute> optional
מציין אילו מסלולי עזר לחשב כחלק מהבקשה, בנוסף למסלול ברירת המחדל. מסלול עזר הוא מסלול עם יעד חישוב מסלול שונה מהמסלול שמוגדר כברירת מחדל. לדוגמה, חישוב מסלול לדוגמה של FUEL_EFFICIENT מביא בחשבון פרמטרים שונים שיפיקו מסלול אופטימלי לחיסכון בדלק. כשמשתמשים בתכונה הזו, צריך לחפש את הסמל Route.routeLabels במסלולים שמוצגים.
routeModifiers optional
סוג:  RouteModifiers optional
קבוצת תנאים שמשפיעים על אופן חישוב המסלולים. לדוגמה, אפשר לציין מאפיינים שרוצים להימנע מהם, כמו כבישי אגרה או כבישים מהירים.
routingPreference optional
סוג:  RoutingPreference optional
מציינת איך לחשב את המסלול. השרת מנסה להשתמש בהעדפת המסלול שנבחרה כדי לחשב את המסלול. אם העדפת הניתוב גורמת לשגיאה או לזמן אחזור ארוך במיוחד, תוחזר שגיאה. אפשר לציין את האפשרות הזו רק כשהערך של ComputeRoutesRequest.travelMode הוא DRIVING או TWO_WHEELER, אחרת הבקשה תיכשל.
trafficModel optional
סוג:  TrafficModel optional
מציין את ההנחות שצריך להשתמש בהן כשמחשבים את הזמן בתנועה. ההגדרה הזו משפיעה על הערך של Route.durationMillis ו-RouteLeg.durationMillis, שמכילים את הזמן החזוי בתנועה על סמך ממוצעים היסטוריים. השדה ComputeRoutesRequest.trafficModel זמין רק לבקשות שבהן השדה ComputeRoutesRequest.routingPreference מוגדר כ-TRAFFIC_AWARE_OPTIMAL והשדה ComputeRoutesRequest.travelMode מוגדר כ-DRIVING. ברירת המחדל היא BEST_GUESS.
transitPreference optional
סוג:  TransitPreference optional
מציינת העדפות שמשפיעות על המסלול שמוחזר למסלולי TRANSIT.

הערה: אפשר לציין את זה רק כש-ComputeRoutesRequest.travelMode מוגדר ל-TRANSIT.
travelMode optional
סוג:  TravelMode optional
מציין את אמצעי התחבורה.
units optional
סוג:  UnitSystem optional
מציינת את יחידות המידה של שדות התצוגה, כמו הוראות ניווט. יחידות המידה שמשמשות למסלול, למקטע, למרחק של השלב ולמשך הזמן לא מושפעות מהערך הזה. אם לא תספקו את הערך הזה, יחידות התצוגה יוסקו מהמיקום של נקודת המוצא.

קבועים של ComputeRoutesExtraComputation

google.maps.routes.ComputeRoutesExtraComputation קבועים

חישובים נוספים שצריך לבצע לבקשת Route.computeRoutes.

כדי לקבל גישה, צריך לקרוא ל: const {ComputeRoutesExtraComputation} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

FLYOVER_INFO_ON_POLYLINE מידע על גשרים במסלולים. כדי להחזיר את המידע הזה, צריך לציין את השדה "polylineDetails" ב-ComputeRoutesRequest.fields. הנתונים האלה יאוכלסו כרגע רק באזורי מטרופולין מסוימים בהודו. התכונה הזו ניסיונית, והמק"ט או החיוב עשויים להשתנות.
FUEL_CONSUMPTION צריכת הדלק המשוערת במסלולים.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS הוראות ניווט שמוצגות כמחרוזת טקסט בפורמט HTML. התוכן הזה נועד לקריאה בלבד ומוצג כפי שהוא. אל תנתחו אותו באופן פרוגרמטי.
NARROW_ROAD_INFO_ON_POLYLINE מידע על כבישים צרים במסלולים. כדי להחזיר את המידע הזה, צריך לציין את השדה "polylineDetails" ב-ComputeRoutesRequest.fields. הנתונים האלה יאוכלסו כרגע רק באזורי מטרופולין מסוימים בהודו. התכונה הזו ניסיונית, והמק"ט או החיוב עשויים להשתנות.
TOLLS מידע על אגרות במסלולים.
TRAFFIC_ON_POLYLINE קווים פוליגוניים מודעים לתנועה עבור המסלולים.

ממשק DirectionalLocationLiteral

ממשק google.maps.routes.DirectionalLocationLiteral

כדי להקל על המשתמשים, אפשר להשתמש בליטרלים של אובייקטים במקום במופעים של DirectionalLocation. הן מומרות ל-DirectionalLocation כש-Maps JS API נתקל בהן.

הממשק הזה מרחיב את LatLngAltitudeLiteral.

heading optional
סוג:  number optional
כיוון המצפן שמשויך לכיוון זרימת התנועה. ערכי הכיוון יכולים להיות מספרים מ-0 עד 360, כאשר 0 מציין כיוון צפון, 90 מציין כיוון מזרח וכן הלאה. אפשר להשתמש בשדה הזה רק ב-DRIVING וב-TWO_WHEELER ComputeRoutesRequest.travelMode.
ירושה: altitude, lat, lng

המחלקה DirectionalLocation

מחלקה google.maps.routes.DirectionalLocation

מכיל נקודה גיאוגרפית וכיוון אופציונלי.

המחלקה הזו מרחיבה את LatLngAltitude.

המחלקה הזו מטמיעה את DirectionalLocationLiteral.

כדי לקבל גישה, צריך לקרוא ל: const {DirectionalLocation} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

בירושה: LatLngAltitude
heading
סוג:  number optional
כיוון המצפן שמשויך לכיוון זרימת התנועה. ערכי הכיוון יכולים להיות מספרים מ-0 עד 360, כאשר 0 מציין כיוון צפון, 90 מציין כיוון מזרח וכן הלאה. אפשר להשתמש בשדה הזה רק ב-DRIVING וב-TWO_WHEELER ComputeRoutesRequest.travelMode.
ירושה: altitude, lat, lng
toJSON
toJSON()
פרמטרים:  אין
ערך מוחזר:  DirectionalLocationLiteral
המרת אובייקט.
בירושה: equals

המחלקה FallbackInfo

מחלקה google.maps.routes.FallbackInfo

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

כדי לקבל גישה, צריך לקרוא ל: const {FallbackInfo} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

reason
סוג:  FallbackReason optional
הסיבה לכך שהמערכת השתמשה בתגובה חלופית במקום בתגובה המקורית. השדה הזה מאוכלס רק כשמצב החלופה מופעל ומוחזרת תגובת החלופה.
routingMode
סוג:  FallbackRoutingMode optional
מצב הניתוב ששימש לתגובה. אם הופעל החלופה, יכול להיות שהמצב יהיה שונה מהעדפת הניתוב שהוגדרה בבקשת הלקוח המקורית.
toJSON
toJSON()
פרמטרים:  אין
ערך מוחזר:  Object
המרת אובייקט.

קבועים של FallbackReason

google.maps.routes.FallbackReason קבועים

הסיבה לכך שהוחזרה תגובה חלופית בתגובה מסוג Route.computeRoutes.

כדי לקבל גישה, צריך לקרוא ל: const {FallbackReason} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

LATENCY_EXCEEDED לא הצלחנו לסיים את החישוב בזמן עם מצב הניתוב המועדף עליך, אבל הצלחנו להחזיר תוצאה שחושבה במצב חלופי.
SERVER_ERROR אירעה שגיאה בחיבור לשרת בזמן חישוב המסלולים באמצעות מצב הניתוב המועדף, אבל הצלחנו להחזיר תוצאה שחושבה באמצעות מצב חלופי.

קבועים של FallbackRoutingMode

google.maps.routes.FallbackRoutingMode קבועים

מצב הניתוב בפועל שבו נעשה שימוש כשמוחזרת תשובה חלופית בתגובה של Route.computeRoutes.

כדי לקבל גישה, צריך לקרוא ל: const {FallbackRoutingMode} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

TRAFFIC_AWARE מציין שהתשובה נוצרה באמצעות TRAFFIC_AWARE RoutingPreference.
TRAFFIC_UNAWARE מציין שהתשובה נוצרה באמצעות TRAFFIC_UNAWARE RoutingPreference.

המחלקה GeocodedWaypoint

מחלקה google.maps.routes.GeocodedWaypoint

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

כדי לקבל גישה, צריך לקרוא ל: const {GeocodedWaypoint} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

geocoderStatus
סוג:  RPCStatus optional
מציין את קוד הסטטוס שנוצר כתוצאה מהפעולה של המרת הכתובת לקואורדינטות.
intermediateWaypointRequestIndex
סוג:  number optional
האינדקס של נקודת הדרך המתאימה בבקשה. השדה הזה מאוכלס רק אם נקודת הדרך המתאימה היא נקודת דרך ביניים.
partialMatch
סוג:  boolean
מציין שהכלי להמרת כתובות לקואורדינטות לא החזיר התאמה מדויקת לבקשה המקורית, אבל הצליח להתאים חלק מהכתובת המבוקשת. כדאי לבדוק אם יש שגיאות כתיב בבקשה המקורית או אם הכתובת לא מלאה.
placeId
סוג:  string
מזהה המקום של התוצאה הזו.
types
סוג:  Array<string>
סוגי התוצאות, בצורה של אפס או יותר תגי סוג. בכתובת https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types מפורטים הסוגים הנתמכים.
toJSON
toJSON()
פרמטרים:  אין
ערך מוחזר:  Object
המרת אובייקט.

GeocodingResults class

מחלקה google.maps.routes.GeocodingResults

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

כדי לקבל גישה, צריך לקרוא ל: const {GeocodingResults} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

destination
סוג:  GeocodedWaypoint optional
ציון הדרך של היעד שהומרה לקואורדינטות.
intermediates
סוג:  Array<GeocodedWaypoint> optional
רשימה של נקודות ביניים שהומרו לקואורדינטות, שכל אחת מהן מכילה שדה אינדקס שתואם למיקום של ציון הדרך לפי הסדר שבו הוא צוין בבקשה, החל מ-0.
origin
סוג:  GeocodedWaypoint optional
ציון הדרך של המוצא שהומר לקואורדינטות.
toJSON
toJSON()
פרמטרים:  אין
ערך מוחזר:  Object
המרת הנתונים לאובייקט.

המחלקה MultiModalSegment

מחלקה google.maps.routes.MultiModalSegment

מספק מידע מסוכם על קטע מרובה-אמצעי תחבורה של RouteLeg.steps במסלול. מקטע מולטי-מודאלי מוגדר כ-RouteLegStep אחד או יותר ברצף שיש להם את אותו TravelMode.

כדי לקבל גישה, צריך לקרוא ל: const {MultiModalSegment} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

instructions
סוג:  string optional
הוראות לניווט בקטע הזה שכולל כמה אמצעי תחבורה.
maneuver
סוג:  string optional
התמרון בניווט שצריך לבצע בשלב הזה. בקטע תמרון תוכלו לעיין ברשימה של הערכים האפשריים.
stepEndIndex
סוג:  number
האינדקס התואם של RouteLegStep שמציין את הסוף של קטע מולטי-מודאלי.
stepStartIndex
סוג:  number
האינדקס התואם של RouteLegStep שמציין את ההתחלה של קטע מולטי-מודאלי.
travelMode
סוג:  TravelMode optional
אמצעי התחבורה שמשמש למקטע המולטי-מודאלי הזה.
toJSON
toJSON()
פרמטרים:  אין
ערך מוחזר:  Object
המרת הנתונים לאובייקט.

המחלקה PolylineDetailInfo

מחלקה google.maps.routes.PolylineDetailInfo

מכיל מידע על מאפיין של כביש לאורך קטע של קו פוליגוני.

כדי לקבל גישה, צריך לקרוא ל: const {PolylineDetailInfo} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

endIndex
סוג:  number optional
אינדקס הסיום של מאפיין הכביש הזה בקו הפוליגוני.
presence
סוג:  RoadFeatureState optional
מציין אם מאפיין הכביש קיים לאורך הקו הפוליגוני.
startIndex
סוג:  number optional
אינדקס ההתחלה של מאפיין הכביש הזה בקו הפוליגוני.
toJSON
toJSON()
פרמטרים:  אין
ערך מוחזר:  Object
המרת הנתונים לאובייקט.

הכיתה PolylineDetails

מחלקה google.maps.routes.PolylineDetails

פרטים שתואמים לאינדקס נתון או לקטע רציף של קו פוליגוני. אם יש קו פוליגוני עם הנקודות P_0, ‏ P_1,‏ ... , ‏ P_N (אינדקס מבוסס-אפס), PolylineDetails מתאר מאפיין של כביש במרווח זמן נתון.

כדי לקבל גישה, צריך לקרוא ל: const {PolylineDetails} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

flyoverInfo
פרטי המעוף לאורך הקו הפוליגוני.
narrowRoadInfo
פרטי הכביש הצר לאורך הקו הפוליגוני.
toJSON
toJSON()
פרמטרים:  אין
ערך מוחזר:  Object
המרת אובייקט.

קבועים של PolylineQuality

google.maps.routes.PolylineQuality קבועים

מציין את האיכות של הקו הפוליגוני.

כדי לקבל גישה, צריך לקרוא ל: const {PolylineQuality} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

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

קבועים של ReferenceRoute

google.maps.routes.ReferenceRoute קבועים

מסלול עזר נתמך ב-ComputeRoutesRequest.

כדי לקבל גישה, צריך לקרוא ל: const {ReferenceRoute} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

FUEL_EFFICIENT מסלול חסכוני בדלק.
SHORTER_DISTANCE מסלול עם מרחק נסיעה קצר יותר.

קבועים של RoadFeatureState

google.maps.routes.RoadFeatureState קבועים

מכיל את המצבים של מאפייני הכביש לאורך קטע של קו פוליגוני.

כדי לקבל גישה, צריך לקרוא ל: const {RoadFeatureState} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

DOES_NOT_EXIST הכביש לא קיים.
EXISTS מאפיין הכביש קיים.

קבועים של RouteLabel

google.maps.routes.RouteLabel קבועים

תוויות למסלול שמועילות לזיהוי מאפיינים ספציפיים להשוואה עם אחרים.

כדי לקבל גישה, צריך לקרוא ל: const {RouteLabel} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

DEFAULT_ROUTE המסלול "הטוב ביותר" שמוחזר כברירת מחדל בחישוב המסלול.
DEFAULT_ROUTE_ALTERNATE חלופה למסלול "הטוב ביותר" שמוגדר כברירת מחדל. מסלולים כאלה יוחזרו כשמציינים את ComputeRoutesRequest.computeAlternativeRoutes.
FUEL_EFFICIENT מסלול חסכוני בדלק. מסלולים שמסומנים בערך הזה נחשבים לאופטימליים מבחינת פרמטרים אקולוגיים כמו צריכת דלק.
SHORTER_DISTANCE מסלול עם מרחק נסיעה קצר יותר. זו תכונה ניסיונית.

המחלקה RouteLeg

מחלקה google.maps.routes.RouteLeg

מכיל קטע בין נקודות ציון שאינן via.

כדי לקבל גישה, צריך לקרוא ל: const {RouteLeg} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

distanceMeters
סוג:  number
מרחק הנסיעה של מקטע המסלול, במטרים.
durationMillis
סוג:  number optional
משך הזמן שנדרש כדי לנווט במקטע המסלול, באלפיות השנייה. אם מגדירים את ComputeRoutesRequest.routingPreference כ-TRAFFIC_UNAWARE, הערך הזה זהה ל-staticDurationMillis. אם מגדירים את ComputeRoutesRequest.routingPreference לערך TRAFFIC_AWARE או TRAFFIC_AWARE_OPTIMAL, הערך הזה מחושב תוך התחשבות במצב התנועה.

הערה: אם משך הזמן חורג מ-‎2^53 אלפיות השנייה, הערך הזה הוא Number.POSITIVE_INFINITY.
endLocation
סוג:  DirectionalLocation optional
מיקום הסיום של המקטע הזה. יכול להיות שהמיקום הזה שונה מהמיקום של ComputeRoutesRequest.destination. לדוגמה, אם ComputeRoutesRequest.destination לא נמצא ליד כביש, זו נקודה על הכביש.
localizedValues
סוג:  RouteLegLocalizedValues optional
ייצוגים בטקסט של מאפייני RouteLeg.
path
רשימת ה-LatLngAltitude של מקטע המסלול, שבה אפשר להשתמש כדי לשרטט קו פוליגוני של מקטע המסלול. אפשר לשלוט ברמת הפירוט של הנתיב באמצעות ההגדרה ComputeRoutesRequest.polylineQuality.
speedPaths
סוג:  Array<SpeedPath>
קיבוץ של קטעים בנתיב של מקטע המסלול עם קריאת המהירות המתאימה. כדי שהשדה הזה יאוכלס, צריך להגדיר את ComputeRoutesRequest.routingPreference ל-TRAFFIC_AWARE או ל-TRAFFIC_AWARE_OPTIMAL, ו-ComputeRoutesRequest.extraComputations צריך לכלול את TRAFFIC_ON_POLYLINE.
startLocation
סוג:  DirectionalLocation optional
מיקום ההתחלה של המקטע הזה. יכול להיות שהמיקום הזה שונה מהמיקום של ComputeRoutesRequest.origin. לדוגמה, אם ComputeRoutesRequest.origin לא נמצא ליד כביש, זו נקודה על הכביש.
staticDurationMillis
סוג:  number optional
משך הנסיעה בקטע בלי להביא בחשבון את מצב התנועה.

הערה: אם משך הזמן חורג מ-‎2^53 אלפיות השנייה, הערך הזה הוא Number.POSITIVE_INFINITY.
steps
סוג:  Array<RouteLegStep>
מערך של שלבים שמציינים מקטעים בתוך החלק הזה. כל שלב מייצג הוראת ניווט אחת.
stepsOverview
סוג:  StepsOverview optional
סקירה כללית של השלבים בRouteLeg הזה. השדה הזה מאוכלס רק במסלולי TRANSIT.
travelAdvisory
סוג:  RouteLegTravelAdvisory optional
מכיל את המידע הנוסף שצריך להודיע למשתמש עליו, כמו הגבלות אפשריות על אזורי תנועה, בקטע של מסלול.
toJSON
toJSON()
פרמטרים:  אין
ערך מוחזר:  Object
המרת אובייקט.

המחלקה RouteLegLocalizedValues

מחלקה google.maps.routes.RouteLegLocalizedValues

ייצוגי טקסט של RouteLeg.

כדי לקבל גישה, צריך לקרוא ל: const {RouteLegLocalizedValues} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

distance
סוג:  string optional
מרחק הנסיעה של מקטע המסלול בפורמט טקסט.
distanceLanguage
סוג:  string optional
קוד השפה בתקן BCP-47 של טקסט המרחק, למשל "en-US" או "sr-Latn".

מידע נוסף זמין בכתובת http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
duration
סוג:  string optional
משך הזמן, מיוצג בפורמט טקסט ומותאם לאזור של השאילתה. לוקח בחשבון את מצב התנועה.
durationLanguage
סוג:  string optional
קוד השפה בתקן BCP-47 של טקסט משך הזמן, למשל "en-US" או "sr-Latn".

מידע נוסף זמין בכתובת http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
staticDuration
סוג:  string optional
משך הזמן בלי להביא בחשבון את מצב התנועה, מיוצג בפורמט טקסט.
staticDurationLanguage
סוג:  string optional
קוד השפה בתקן BCP-47 של הטקסט הסטטי של משך הזמן, למשל "en-US" או "sr-Latn".
toJSON
toJSON()
פרמטרים:  אין
ערך מוחזר:  Object
המרת הנתונים לאובייקט.

המחלקה RouteLegStep

מחלקה google.maps.routes.RouteLegStep

מכיל פלח של RouteLeg. שלב תואם להוראת ניווט אחת. מקטעי המסלול מורכבים משלבים.

כדי לקבל גישה, צריך לקרוא ל: const {RouteLegStep} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

distanceMeters
סוג:  number
מרחק הנסיעה של השלב הזה, במטרים.
endLocation
סוג:  DirectionalLocation optional
מיקום הסיום של השלב הזה.
instructions
סוג:  string optional
הוראות לניווט בשלב הזה.
localizedValues
סוג:  RouteLegStepLocalizedValues optional
ייצוגים בטקסט של מאפייני RouteLegStep.
maneuver
סוג:  string optional
התמרון בניווט שצריך לבצע בשלב הזה. בקטע תמרון תוכלו לעיין ברשימה של הערכים האפשריים.
path
רשימת LatLngAltitude של השלב במקטע המסלול, שבה אפשר להשתמש כדי לשרטט קו פוליגוני של השלב במקטע המסלול. אפשר לשלוט ברמת הפירוט של הנתיב באמצעות ההגדרה ComputeRoutesRequest.polylineQuality. כדי שהשדה הזה יאוכלס, צריך לבקש את השדה "path" ב-ComputeRoutesRequest.fields.
startLocation
סוג:  DirectionalLocation optional
מיקום ההתחלה של השלב הזה.
staticDurationMillis
סוג:  number optional
משך הנסיעה בשלב הזה בלי להביא בחשבון את מצב התנועה.

הערה: אם משך הזמן חורג מ-‎2^53 אלפיות השנייה, הערך הזה הוא Number.POSITIVE_INFINITY.
transitDetails
סוג:  TransitDetails optional
פרטים שקשורים לשלב הזה אם אמצעי התחבורה הוא TRANSIT.
travelMode
סוג:  TravelMode optional
אמצעי התחבורה שמשמש לשלב הזה.
toJSON
toJSON()
פרמטרים:  אין
ערך מוחזר:  Object
המרת אובייקט.

המחלקה RouteLegStepLocalizedValues

מחלקה google.maps.routes.RouteLegStepLocalizedValues

ייצוגים בטקסט של מאפייני RouteLegStep.

כדי לקבל גישה, צריך לקרוא ל: const {RouteLegStepLocalizedValues} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

distance
סוג:  string optional
מרחק הנסיעה של השלב במקטע המסלול, בפורמט טקסט.
distanceLanguage
סוג:  string optional
קוד השפה בתקן BCP-47 של טקסט המרחק, למשל "en-US" או "sr-Latn".

מידע נוסף זמין בכתובת http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
staticDuration
סוג:  string optional
משך הזמן בלי להביא בחשבון את מצב התנועה, מיוצג בפורמט טקסט.
staticDurationLanguage
סוג:  string optional
קוד השפה בתקן BCP-47 של הטקסט הסטטי של משך הזמן, למשל "en-US" או "sr-Latn".

מידע נוסף זמין בכתובת http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
toJSON
toJSON()
פרמטרים:  אין
ערך מוחזר:  Object
המרת הנתונים לאובייקט.

המחלקה RouteLegTravelAdvisory

מחלקה google.maps.routes.RouteLegTravelAdvisory

מכיל מידע נוסף שצריך להודיע עליו למשתמש ב-RouteLeg.

כדי לקבל גישה, צריך לקרוא ל: const {RouteLegTravelAdvisory} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

speedReadingIntervals
סוג:  Array<SpeedReadingInterval> optional
מרווחי קריאת מהירות שמפרטים את צפיפות התנועה. רלוונטי במקרה של TRAFFIC_AWARE ו-TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routingPreference. המרווחים מכסים את כל הקו הפוליגוני של RouteLeg בלי חפיפה. נקודת ההתחלה של מרווח זמן מסוים זהה לנקודת הסיום של מרווח הזמן הקודם.

דוגמה:
  polyline: A ---- B ---- C ---- D ---- E ---- F ---- G 
speedReadingIntervals: [A,C), [C,D), [D,G)
tollInfo
סוג:  TollInfo optional
מכיל מידע על אגרות בRouteLeg הספציפי. השדה הזה מאוכלס רק אם צפויים כבישי אגרה בRouteLeg. אם השדה הזה מוגדר אבל השדה TollInfo.estimatedPrices לא מאוכלס,אז מקטע המסלול מכיל כבישי אגרה אבל המחיר המשוער לא ידוע. אם השדה הזה ריק, אין כבישי אגרה בRouteLeg.
toJSON
toJSON()
פרמטרים:  אין
ערך מוחזר:  Object
המרת אובייקט.

המחלקה RouteLocalizedValues

מחלקה google.maps.routes.RouteLocalizedValues

ייצוגים בטקסט של מאפייני Route.

כדי לקבל גישה, צריך לקרוא ל: const {RouteLocalizedValues} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

distance
סוג:  string optional
מרחק הנסיעה במסלול, מיוצג בפורמט טקסט.
distanceLanguage
סוג:  string optional
קוד השפה בתקן BCP-47 של טקסט המרחק, למשל "en-US" או "sr-Latn".

מידע נוסף זמין בכתובת http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
duration
סוג:  string optional
משך הזמן, מיוצג בפורמט טקסט ומותאם לאזור של השאילתה. לוקח בחשבון את מצב התנועה. הערה: אם לא ביקשתם מידע על התנועה, הערך הזה זהה לערך של staticDuration.
durationLanguage
סוג:  string optional
קוד השפה בתקן BCP-47 של טקסט משך הזמן, למשל "en-US" או "sr-Latn".

מידע נוסף זמין בכתובת http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
staticDuration
סוג:  string optional
משך הזמן בלי להביא בחשבון את מצב התנועה, מיוצג בפורמט טקסט.
staticDurationLanguage
סוג:  string optional
קוד השפה בתקן BCP-47 של הטקסט הסטטי של משך הזמן, למשל "en-US" או "sr-Latn".
transitFare
סוג:  string optional
תעריף הנסיעה בתחבורה הציבורית מיוצג בפורמט טקסט.
transitFareLanguage
סוג:  string optional
קוד השפה בתקן BCP-47 של הטקסט של תעריף הנסיעה, למשל "en-US" או "sr-Latn".
toJSON
toJSON()
פרמטרים:  אין
ערך מוחזר:  Object
המרת אובייקט.

ממשק RouteModifiers

ממשק google.maps.routes.RouteModifiers

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

avoidFerries optional
סוג:  boolean optional
כשהערך הוא true, המערכת נמנעת ממעבורות כשאפשר, ומעדיפה מסלולים שלא כוללים מעבורות. ההגדרה חלה רק על DRIVING או TWO_WHEELER TravelMode.
avoidHighways optional
סוג:  boolean optional
כשהערך הוא true, המערכת נמנעת מכבישים מהירים כשאפשר, ונותנת עדיפות למסלולים שלא כוללים כבישים מהירים. ההגדרה חלה רק על DRIVING או TWO_WHEELER TravelMode.
avoidIndoor optional
סוג:  boolean optional
כשהערך הוא true, המערכת נמנעת מניווט בתוך מבנים כשאפשר, ומעדיפה מסלולים שלא כוללים ניווט בתוך מבנים. ההגדרה רלוונטית רק ל-WALKING TravelMode.
avoidTolls optional
סוג:  boolean optional
כשהערך הוא true, המערכת נמנעת מכבישי אגרה כשאפשר, ומעדיפה מסלולים שלא כוללים כבישי אגרה. ההגדרה חלה רק על DRIVING או TWO_WHEELER TravelMode.
tollPasses optional
סוג:  Iterable<string> optional
מכיל מידע על מינויים לכבישי אגרה. אם מספקים מינויים לכבישי אגרה, ה-API מנסה להחזיר את מחיר המינוי. אם לא מציינים מינויים לכבישי אגרה, ה-API מתייחס למינוי לכביש האגרה כלא ידוע ומנסה להחזיר את המחיר במזומן. ההגדרה חלה רק על DRIVING או TWO_WHEELER TravelMode. רשימה של ערכים תקינים מופיעה במאמר TollPass.
vehicleInfo optional
סוג:  VehicleInfo optional
מציינת את פרטי הרכב.

ממשק RoutePolylineDetails

ממשק google.maps.routes.RoutePolylineDetails

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

speed optional
סוג:  Speed optional
קריאת המהירות של קטע המסלול שתואם לקו הפוליגוני הזה. השדה הזה מאוכלס רק במסלולים עם מידע על מצב התנועה.
transitDetails optional
סוג:  TransitDetails optional
פרטי התחבורה הציבורית של קטע המסלול שתואם לקו הפוליגוני הזה. השדה הזה מאוכלס רק במסלולים עם מידע על תחבורה ציבורית.
travelMode optional
סוג:  TravelMode optional
אמצעי התחבורה בקטע של המסלול שתואם לקו הפוליגוני הזה. ריק לקווים פוליגוניים של תנועה.

ממשק RoutePolylineOptions

ממשק google.maps.routes.RoutePolylineOptions

אפשרויות ליצירת קווים פוליגוניים של מסלולים.

colorScheme optional
סוג:  ColorScheme optional
ערכת הצבעים של הקו הפוליגוני. אם מציינים FOLLOW_SYSTEM כשהמפה colorScheme היא גם FOLLOW_SYSTEM, הקווים הפוליגוניים ישורטטו באותו מצב כהה/בהיר כמו המפה. אם לא מציינים שפה, Route.createPolylines מנסה להשתמש בcolorScheme של המפה או חוזר לברירת המחדל של המערכת.
polylineOptions optional
אפשרויות להתאמה אישית של הסגנון של קו פוליגוני. יכול להיות אובייקט PolylineOptions שמוחל על כל הקווים הפוליגוניים של המסלול, או פונקציה שמקבלת את ברירות המחדל PolylineOptions ו-RoutePolylineDetails ומחזירה את PolylineOptions שיוחל על הקו הפוליגוני הזה.

המחלקה RouteTravelAdvisory

מחלקה google.maps.routes.RouteTravelAdvisory

מכיל מידע נוסף שצריך להודיע עליו למשתמש ב-Route.

כדי לקבל גישה, צריך לקרוא ל: const {RouteTravelAdvisory} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

fuelConsumptionMicroliters
סוג:  number optional
צריכת הדלק החזויה במיקרוליטרים.

הערה: אם צריכת הדלק חורגת מ-‎2^53 מיקרוליטר, הערך הזה הוא Number.POSITIVE_INFINITY.
routeRestrictionsPartiallyIgnored
סוג:  boolean optional
יכול להיות שבRoute יש הגבלות שלא מתאימות לאמצעי התחבורה או לשינויים במסלול שביקשת.
speedReadingIntervals
סוג:  Array<SpeedReadingInterval> optional
מרווחי קריאת מהירות שמפרטים את צפיפות התנועה. רלוונטי במקרה של TRAFFIC_AWARE ו-TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routingPreference. המרווחים מכסים את כל הקו הפוליגוני של Route בלי חפיפה. נקודת ההתחלה של מרווח זמן מסוים זהה לנקודת הסיום של מרווח הזמן הקודם.

דוגמה:
  polyline: A ---- B ---- C ---- D ---- E ---- F ---- G 
speedReadingIntervals: [A,C), [C,D), [D,G)
tollInfo
סוג:  TollInfo optional
מכיל מידע על אגרות בכביש Route. השדה הזה מאוכלס רק אם צפויים כבישי אגרה בRoute. אם השדה הזה מוגדר אבל השדה TollInfo.estimatedPrices לא מאוכלס,המסלול כולל כבישי אגרה אבל המחיר המשוער לא ידוע. אם השדה הזה ריק, אין כבישי אגרה בRoute.
transitFare
סוג:  Money optional
אם הוא קיים, הוא מכיל את העלות הכוללת של הנסיעה או הכרטיס של Route. המאפיין הזה מוחזר רק עבור TRANSIT ComputeRoutesRequest.travelMode ורק עבור מסלולים שבהם מידע על תעריפים זמין לכל שלבי הנסיעה בתחבורה הציבורית.
toJSON
toJSON()
פרמטרים:  אין
ערך מוחזר:  Object
המרת הנתונים לאובייקט.

קבועים של RoutingPreference

google.maps.routes.RoutingPreference קבועים

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

כדי לקבל גישה, צריך לקרוא ל: const {RoutingPreference} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

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

קבועי מהירות

google.maps.routes.Speed קבועים

סיווג המהירות של הקו הפוליגוני על סמך נתוני התנועה.

כדי לקבל גישה, צריך לקרוא ל: const {Speed} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

NORMAL מהירות רגילה, אין עיכובים בתנועה.
SLOW זוהתה האטה, עומס תנועה בינוני.
TRAFFIC_JAM עיכובים בתנועה.

ממשק SpeedPath

ממשק google.maps.routes.SpeedPath

מקבץ את LatLngAltitude של קטע מסלול עם קריאת המהירות של הקטע.

path
הנתיב שבו נמדדת המהירות.
speed optional
סוג:  Speed optional
מהירות הנסיעה בנתיב.

המחלקה SpeedReadingInterval

מחלקה google.maps.routes.SpeedReadingInterval

אינדיקטור של צפיפות התנועה בקטע רציף של קו פוליגוני או מסלול. במסלול עם הנקודות P_0, ‏ P_1,‏ ... , ‏ P_N (אינדקס מבוסס-אפס), SpeedReadingInterval מתאר את צפיפות התנועה במרווח זמן מסוים.

כדי לקבל גישה, צריך לקרוא ל: const {SpeedReadingInterval} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

endPolylinePointIndex
סוג:  number optional
אינדקס הסיום של המרווח הזה בקו הפוליגוני.
speed
סוג:  Speed optional
מהירות התנועה במרווח הזמן הזה.
startPolylinePointIndex
סוג:  number optional
האינדקס ההתחלתי של המרווח הזה בקו הפוליגוני.
toJSON
toJSON()
פרמטרים:  אין
ערך מוחזר:  אין
המרת אובייקט.

StepsOverview class

מחלקה google.maps.routes.StepsOverview

סקירה כללית על רשימה של RouteLeg.steps.

כדי לקבל גישה, צריך לקרוא ל: const {StepsOverview} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

multiModalSegments
מידע מסוכם על קטעים מולטי-מודאליים שונים של RouteLeg.steps.
toJSON
toJSON()
פרמטרים:  אין
ערך מוחזר:  Object
המרת הנתונים לאובייקט.

המחלקה TollInfo

מחלקה google.maps.routes.TollInfo

מכיל מידע על אגרה בRoute או בRouteLeg.

כדי לקבל גישה, צריך לקרוא ל: const {TollInfo} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

estimatedPrices
סוג:  Array<Money> optional
הסכום הכספי של אגרות הנסיעה בכביש Route או RouteLeg המתאים. הרשימה הזו מכילה סכום לכל מטבע שצפוי להיות מחויב על ידי תחנות אגרה. בדרך כלל הרשימה הזו תכיל רק פריט אחד למסלולים עם אגרות במטבע אחד. בנסיעות בינלאומיות, הרשימה הזו יכולה להכיל כמה פריטים כדי לשקף את אגרות הכביש במטבעות שונים.
toJSON
toJSON()
פרמטרים:  אין
ערך מוחזר:  Object
המרת אובייקט.

מחלקה TransitAgency

מחלקה google.maps.routes.TransitAgency

מידע על חברת תחבורה ציבורית.

כדי לקבל גישה, צריך לקרוא ל: const {TransitAgency} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

name
סוג:  string optional
השם של חברת התחבורה הציבורית הזו.
phoneNumber
סוג:  string optional
מספר הטלפון של חברת התחבורה הציבורית, בפורמט שמתאים למיקום הגיאוגרפי.
url
סוג:  URL optional
כתובת ה-URL של חברת התחבורה הציבורית.
toJSON
toJSON()
פרמטרים:  אין
ערך מוחזר:  Object
המרת אובייקט.

הכיתה TransitDetails

מחלקה google.maps.routes.TransitDetails

מידע נוסף על שלב במסלול של תחבורה ציבורית.

כדי לקבל גישה, צריך לקרוא ל: const {TransitDetails} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

arrivalStop
סוג:  TransitStop optional
מידע על תחנת ההגעה של השלב.
arrivalTime
סוג:  Date optional
זמן ההגעה המשוער לשלב.
departureStop
סוג:  TransitStop optional
מידע על תחנת היציאה של השלב.
departureTime
סוג:  Date optional
שעת היציאה המשוערת של השלב.
headsign
סוג:  string optional
מציין את כיוון הנסיעה בקו הזה, כפי שהוא מסומן על הרכב או בתחנת היציאה. הכיוון הוא בדרך כלל התחנה הסופית.
headwayMillis
סוג:  number optional
מציין את הזמן הצפוי באלפיות השנייה בין יציאות מאותה תחנה בשעה הזו. לדוגמה, אם ערך המרווח הוא 600,000, זמן ההמתנה הצפוי אם פספסתם את האוטובוס הוא 10 דקות.

הערה: אם מרווח הזמן בין הנסיעות עולה על 2 בחזקת 53 אלפיות השנייה, הערך הזה הוא Number.POSITIVE_INFINITY.
stopCount
סוג:  number
מספר התחנות מתחנת המוצא ועד לתחנת היעד. המספר הזה כולל את תחנת ההגעה, אבל לא את תחנת היציאה. לדוגמה, אם המסלול יוצא מתחנה א', עובר דרך תחנות ב' וג' ומגיע לתחנה ד', הערך של stopCount יהיה 3.
transitLine
סוג:  TransitLine optional
מידע על קו התחבורה הציבורית שמשמש בשלב.
tripShortText
סוג:  string optional
הטקסט שמופיע בלוחות הזמנים ובשלטים כדי לזהות נסיעה בתחבורה ציבורית עבור הנוסעים. הטקסט מזהה באופן ייחודי נסיעה ביום שירות. לדוגמה, "538" הוא tripShortText של רכבת Amtrak שיוצאת מסן חוזה, קליפורניה בשעה 15:10 בימי חול לסקרמנטו, קליפורניה.
toJSON
toJSON()
פרמטרים:  אין
ערך מוחזר:  Object
המרת אובייקט.

מחלקה TransitLine

מחלקה google.maps.routes.TransitLine

מידע על קו תחבורה ציבורית.

כדי לקבל גישה, צריך לקרוא ל: const {TransitLine} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

agencies
סוג:  Array<TransitAgency>
חברת התחבורה הציבורית (או החברות) שמפעילה את קו התחבורה הציבורית הזה.
color
סוג:  string optional
הצבע שמופיע בדרך כלל בשילוט של הקו הזה. מיוצג בבסיס הקסדצימלי.
iconURL
סוג:  URL optional
כתובת ה-URL של הסמל שמשויך לשורה הזו.
name
סוג:  string optional
השם המלא של קו התחבורה הציבורית, לדוגמה, "8 Avenue Local".
shortName
סוג:  string optional
השם המקוצר של קו התחבורה הציבורית הזה. השם הזה יהיה בדרך כלל מספר קו, כמו "M7" או "355".
textColor
סוג:  string optional
הצבע שמופיע בדרך כלל בטקסט בשילוט של הקו הזה. מיוצג בבסיס הקסדצימלי.
url
סוג:  URL optional
כתובת ה-URL של קו התחבורה הציבורית הזה, כפי שסופקה על ידי חברת התחבורה הציבורית.
vehicle
סוג:  TransitVehicle optional
סוג כלי הרכב שפועל בקו התחבורה הציבורית הזה.
toJSON
toJSON()
פרמטרים:  אין
ערך מוחזר:  Object
המרת אובייקט.

ממשק TransitPreference

ממשק google.maps.routes.TransitPreference

העדפות למסלולים שמבוססים על TRANSIT, שמשפיעות על המסלול שמוחזר.

allowedTransitModes optional
סוג:  Iterable<TransitMode> optional
קבוצה של אמצעי תחבורה שבהם אפשר להשתמש כשמקבלים מסלול ב-TRANSIT. כברירת מחדל, כל אמצעי ההגעה הנתמכים.
routingPreference optional
סוג:  TransitRoutePreference optional
העדפת מסלול שמשפיעה על המסלול שמוחזר על ידי TRANSIT, אם היא צוינה.

מחלקה TransitStop

מחלקה google.maps.routes.TransitStop

מידע על תחנה של תחבורה ציבורית.

כדי לקבל גישה, צריך לקרוא ל: const {TransitStop} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

location
סוג:  DirectionalLocation optional
מיקום התחנה, שמיוצג על ידי קואורדינטות של קו רוחב/קו אורך וכיוון (אופציונלי).
name
סוג:  string optional
שם התחנה של התחבורה הציבורית.
toJSON
toJSON()
פרמטרים:  אין
ערך מוחזר:  Object
המרת אובייקט.

מחלקה TransitVehicle

מחלקה google.maps.routes.TransitVehicle

מידע על כלי רכב שמשמש במסלולי תחבורה ציבורית.

כדי לקבל גישה, צריך לקרוא ל: const {TransitVehicle} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

iconURL
סוג:  URL optional
כתובת ה-URL של סמל שמשויך לסוג כלי רכב זה.
localIconURL
סוג:  URL optional
כתובת ה-URL של הסמל שמשויך לסוג כלי הרכב הזה, על סמך השילוט של התחבורה המקומית.
name
סוג:  string optional
שם הרכב, באותיות רישיות.
nameLanguage
סוג:  string optional
קוד השפה בתקן BCP-47 של טקסט שם הרכב, למשל "en-US" או "sr-Latn".

מידע נוסף זמין בכתובת: https://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
vehicleType
סוג:  string optional
סוג הרכב שבו השתמשתם.

רשימה של ערכים אפשריים זמינה בכתובת https://developers.google.com/maps/documentation/routes/reference/rpc/google.maps.routing.v2#transitvehicletype.
toJSON
toJSON()
פרמטרים:  אין
ערך מוחזר:  Object
המרת אובייקט.

קבועים של VehicleEmissionType

google.maps.routes.VehicleEmissionType קבועים

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

כדי לקבל גישה, צריך לקרוא ל: const {VehicleEmissionType} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

DIESEL רכב שמונע בדיזל.
ELECTRIC רכב שמופעל באמצעות חשמל.
GASOLINE רכב שמונע בבנזין.
HYBRID רכב היברידי (למשל, בנזין וחשמל).

ממשק VehicleInfo

ממשק google.maps.routes.VehicleInfo

מכיל את פרטי הרכב, כמו סוג פליטת הרכב.

emissionType optional
סוג:  VehicleEmissionType optional
מתאר את סוג הפליטות של הרכב. ההגדרה חלה רק על אופן ההתניידות DRIVING.

ממשק Waypoint

ממשק google.maps.routes.Waypoint

מייצג נקודת דרך במסלול.

location
המיקום של ציון הדרך. מחרוזת יכולה להיות כתובת, Plus Code או שם של משאב מקום.
sideOfRoad optional
סוג:  boolean optional
מציין שהמיקום של נקודת הדרך הזו נועד להעדפה שהרכב יעצור בצד מסוים של הכביש. כשמגדירים את הערך הזה, המסלול יעבור דרך המיקום כך שהרכב יוכל לעצור בצד הכביש שהמיקום נוטה אליו ממרכז הכביש. האפשרות הזו פועלת רק ב-DRIVING וב-TWO_WHEELER ComputeRoutesRequest.travelMode
vehicleStopover optional
סוג:  boolean optional
מציין שציון הדרך מיועד לעצירת רכבים, במטרה לאסוף או להוריד. כשמגדירים את הערך הזה, המסלול המחושב לא יכלול ציוני דרך שאינם via בכבישים שלא מתאימים לאיסוף ולהורדה. האפשרות הזו פועלת רק עבור DRIVING ו-TWO_WHEELER ComputeRoutesRequest.travelMode וכאשר Waypoint.location אינו string או Place.
via optional
סוג:  boolean optional
מסמן את נקודת הדרך הזו כאבן דרך ולא כנקודת עצירה. לכל נקודת ציון שאינה via ב-ComputeRoutesRequest, Route.computeRoutes מוסיפה רשומה למערך Route.legs כדי לספק את הפרטים של עצירות הביניים בקטע הזה של הנסיעה.

צריך להגדיר את הערך הזה בתור true אם רוצים שהמסלול יעבור דרך נקודת הדרך הזו בלי לעצור בה. נקודות ציון מסוג Via לא גורמות להוספת רשומה למערך Route.legs, אבל הן מנתבות את הנסיעה דרך נקודת הציון.

הערות:
  • אפשר להגדיר את הערך הזה רק בנקודות ביניים. הבקשה תיכשל אם תגדירו את השדה הזה בנקודות ציון סופיות.
  • אם ComputeRoutesRequest.optimizeWaypointOrder מוגדר ל-true, אי אפשר להגדיר את השדה הזה ל-true. אחרת, הבקשה תיכשל.

הממשק WaypointMarkerDetails

ממשק google.maps.routes.WaypointMarkerDetails

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

index
סוג:  number
האינדקס של הסמן.
totalMarkers
סוג:  number
מספר הסמנים הכולל במסלול.
leg optional
סוג:  RouteLeg optional
הקטע שאליו שייך הסמן. השדה ריק אם אין מקטעים במסלול.