מחלקה Route
מחלקה google.maps.routes.Route
מכיל מסלול שמורכב מסדרה של מקטעי כביש מחוברים שמחברים בין נקודות הדרך בהתחלה, בסוף ובאמצע.
כדי לקבל גישה, צריך לקרוא ל: const {Route} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.
שיטות סטטיות | |
|---|---|
computeRoutes |
computeRoutes(request)פרמטרים:
ערך מוחזר:
Promise<{הפונקציה מחזירה את המסלול הראשי יחד עם מסלולים חלופיים אופציונליים, בהינתן קבוצה של נקודות ציון סופיות ונקודות ציון ביניים. הערה: בשיטה הזו צריך לציין מסכת שדה תגובה בבקשה על ידי הגדרת המאפיין ComputeRoutesRequest.fields. הערך הוא רשימה של נתיבי שדות. לדוגמה:
לא מומלץ להשתמש באנונימיזציה של שדות בתגובה עם תו כללי לחיפוש 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 |
אוסף של מקטעים (קטעי מסלול בין נקודות ציון) שמרכיבים את המסלול. כל קטע תואם לנסיעה בין שתי נקודות ציון שאינן 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 |
קבוצות של קטעים בנתיב המסלול עם קריאת המהירות המתאימה להם. כדי שהשדה הזה יאוכלס, צריך להגדיר את 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מערך של אזהרות שיוצגו כשמציגים את המסלול. |
Methods | |
|---|---|
createPolylines |
createPolylines([options])פרמטרים:
יצירת קווים פוליגוניים למסלול על סמך הנתונים הזמינים. קווים פוליגוניים של כמה אמצעי תחבורה:
קווים פוליגוניים של תנועה:
קו פוליגוני כולל:
|
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 |
סוג:
Iterable<ComputeRoutesExtraComputation> optionalרשימה של חישובים נוספים שאפשר להשתמש בהם כדי להשלים את הבקשה. הערה: החישובים הנוספים האלה עשויים להחזיר שדות נוספים בתגובה. כדי שהשדות הנוספים האלה יוחזרו בתגובה, צריך לציין אותם גם ב- ComputeRoutesRequest.fields. |
intermediates 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
| |
Methods | |
|---|---|
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מצב הניתוב ששימש לתגובה. אם הופעל החלופה, יכול להיות שהמצב יהיה שונה מהעדפת הניתוב שהוגדרה בבקשת הלקוח המקורית. |
Methods | |
|---|---|
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 מפורטים הסוגים הנתמכים. |
Methods | |
|---|---|
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ציון הדרך של המוצא שהומר לקואורדינטות. |
Methods | |
|---|---|
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אמצעי התחבורה שמשמש למקטע המולטי-מודאלי הזה. |
Methods | |
|---|---|
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אינדקס ההתחלה של מאפיין הכביש הזה בקו הפוליגוני. |
Methods | |
|---|---|
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 |
סוג:
Array<PolylineDetailInfo>פרטי המעוף לאורך הקו הפוליגוני. |
narrowRoadInfo |
סוג:
Array<PolylineDetailInfo>פרטי הכביש הצר לאורך הקו הפוליגוני. |
Methods | |
|---|---|
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 |
סוג:
Array<LatLngAltitude>רשימת ה- LatLngAltitude של מקטע המסלול, שבה אפשר להשתמש כדי לשרטט קו פוליגוני של מקטע המסלול. אפשר לשלוט ברמת הפירוט של הנתיב באמצעות ההגדרה ComputeRoutesRequest.polylineQuality. |
speedPaths |
קיבוץ של קטעים בנתיב של מקטע המסלול עם קריאת המהירות המתאימה. כדי שהשדה הזה יאוכלס, צריך להגדיר את 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מכיל את המידע הנוסף שצריך להודיע למשתמש עליו, כמו הגבלות אפשריות על אזורי תנועה, בקטע של מסלול. |
Methods | |
|---|---|
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". |
Methods | |
|---|---|
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 |
סוג:
Array<LatLngAltitude>רשימת LatLngAltitude של השלב במקטע המסלול, שבה אפשר להשתמש כדי לשרטט קו פוליגוני של השלב במקטע המסלול. אפשר לשלוט ברמת הפירוט של הנתיב באמצעות ההגדרה ComputeRoutesRequest.polylineQuality. כדי שהשדה הזה יאוכלס, צריך לבקש את השדה "path" ב-ComputeRoutesRequest.fields. |
startLocation |
סוג:
DirectionalLocation optionalמיקום ההתחלה של השלב הזה. |
staticDurationMillis |
סוג:
number optionalמשך הנסיעה בשלב הזה בלי להביא בחשבון את מצב התנועה. הערה: אם משך הזמן חורג מ-2^53 אלפיות השנייה, הערך הזה הוא Number.POSITIVE_INFINITY. |
transitDetails |
סוג:
TransitDetails optionalפרטים שקשורים לשלב הזה אם אמצעי התחבורה הוא TRANSIT. |
travelMode |
סוג:
TravelMode optionalאמצעי התחבורה שמשמש לשלב הזה. |
Methods | |
|---|---|
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. |
Methods | |
|---|---|
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 בלי חפיפה. נקודת ההתחלה של מרווח זמן מסוים זהה לנקודת הסיום של מרווח הזמן הקודם. דוגמה: |
tollInfo |
סוג:
TollInfo optionalמכיל מידע על אגרות ב RouteLeg הספציפי. השדה הזה מאוכלס רק אם צפויים כבישי אגרה בRouteLeg. אם השדה הזה מוגדר אבל השדה TollInfo.estimatedPrices לא מאוכלס,אז מקטע המסלול מכיל כבישי אגרה אבל המחיר המשוער לא ידוע. אם השדה הזה ריק, אין כבישי אגרה בRouteLeg. |
Methods | |
|---|---|
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". |
Methods | |
|---|---|
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|(function(PolylineOptions, RoutePolylineDetails): 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 בלי חפיפה. נקודת ההתחלה של מרווח זמן מסוים זהה לנקודת הסיום של מרווח הזמן הקודם. דוגמה: |
tollInfo |
סוג:
TollInfo optionalמכיל מידע על אגרות בכביש Route. השדה הזה מאוכלס רק אם צפויים כבישי אגרה בRoute. אם השדה הזה מוגדר אבל השדה TollInfo.estimatedPrices לא מאוכלס,המסלול כולל כבישי אגרה אבל המחיר המשוער לא ידוע. אם השדה הזה ריק, אין כבישי אגרה בRoute. |
transitFare |
סוג:
Money optionalאם הוא קיים, הוא מכיל את העלות הכוללת של הנסיעה או הכרטיס של Route. המאפיין הזה מוחזר רק עבור TRANSIT ComputeRoutesRequest.travelMode ורק עבור מסלולים שבהם מידע על תעריפים זמין לכל שלבי הנסיעה בתחבורה הציבורית. |
Methods | |
|---|---|
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 |
סוג:
Array<LatLngAltitude>הנתיב שבו נמדדת המהירות. |
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האינדקס ההתחלתי של המרווח הזה בקו הפוליגוני. |
Methods | |
|---|---|
toJSON |
toJSON()פרמטרים: אין
ערך מוחזר: אין
המרת אובייקט. |
StepsOverview class
מחלקה google.maps.routes.StepsOverview
סקירה כללית על רשימה של RouteLeg.steps.
כדי לקבל גישה, צריך לקרוא ל: const {StepsOverview} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.
מאפיינים | |
|---|---|
multiModalSegments |
סוג:
Array<MultiModalSegment>מידע מסוכם על קטעים מולטי-מודאליים שונים של RouteLeg.steps. |
Methods | |
|---|---|
toJSON |
toJSON()פרמטרים: אין
ערך מוחזר:
Objectהמרת הנתונים לאובייקט. |
המחלקה TollInfo
מחלקה google.maps.routes.TollInfo
מכיל מידע על אגרה בRoute או בRouteLeg.
כדי לקבל גישה, צריך לקרוא ל: const {TollInfo} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.
מאפיינים | |
|---|---|
estimatedPrices |
|
Methods | |
|---|---|
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 של חברת התחבורה הציבורית. |
Methods | |
|---|---|
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 בימי חול לסקרמנטו, קליפורניה. |
Methods | |
|---|---|
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סוג כלי הרכב שפועל בקו התחבורה הציבורית הזה. |
Methods | |
|---|---|
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שם התחנה של התחבורה הציבורית. |
Methods | |
|---|---|
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. |
Methods | |
|---|---|
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, אבל הן מנתבות את הנסיעה דרך נקודת הציון. הערות:
|
הממשק WaypointMarkerDetails
ממשק google.maps.routes.WaypointMarkerDetails
פרטים על ציון דרך שאפשר להשתמש בו כדי להתאים אישית את סגנון הסמן.
מאפיינים | |
|---|---|
index |
סוג:
numberהאינדקס של הסמן. |
totalMarkers |
סוג:
numberמספר הסמנים הכולל במסלול. |
leg optional |
סוג:
RouteLeg optionalהקטע שאליו שייך הסמן. השדה ריק אם אין מקטעים במסלול. |