Directions

‫DirectionsService class

google.maps.DirectionsService class

שירות לחישוב מסלולים בין שני מקומות או יותר.

אפשר להתקשר אל const {DirectionsService} = await google.maps.importLibrary("routes") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.
DirectionsService
DirectionsService()
פרמטרים:  אין
יוצר מופע חדש של DirectionsService ששולח שאילתות של הוראות הגעה לשרתים של Google.
route
route(request[, callback])
פרמטרים: 
ערך מוחזר:  Promise<DirectionsResult>
שליחת בקשה לחיפוש מסלול.

ממשק DirectionsRequest

google.maps.DirectionsRequest ממשק

שאילתת מסלול שתישלח אל DirectionsService.
destination
סוג:  string|LatLng|Place|LatLngLiteral
מיקום היעד. אפשר לציין את המיקום כמחרוזת לגיאו-קידוד, כ-LatLng או כ-Place. חובה.
origin
סוג:  string|LatLng|Place|LatLngLiteral
מיקום המוצא. אפשר לציין את המיקום כמחרוזת לגיאו-קידוד, כ-LatLng או כ-Place. חובה.
travelMode
סוג:  TravelMode
סוג הניתוב המבוקש. חובה.
avoidFerries optional
סוג:  boolean optional
אם true, שירות הכיוונים ינסה להימנע ממעבורות ככל האפשר. אופציונלי.
avoidHighways optional
סוג:  boolean optional
אם true, שירות הכיוונים ינסה להימנע מכבישים מהירים ככל האפשר. אופציונלי.
avoidTolls optional
סוג:  boolean optional
אם true, שירות הניווט ינסה להימנע מכבישי אגרה. אופציונלי.
drivingOptions optional
סוג:  DrivingOptions optional
הגדרות שחלות רק על בקשות שבהן travelMode הוא DRIVING. לאובייקט הזה לא תהיה השפעה על אמצעי תחבורה אחרים.
language optional
סוג:  string optional
מזהה שפה של השפה שבה צריך להחזיר את התוצאות, אם אפשר. כאן אפשר לעיין ברשימת השפות הנתמכות.
optimizeWaypoints optional
סוג:  boolean optional
אם המדיניות מוגדרת לערך true, המערכת DirectionsService תנסה לסדר מחדש את נקודות הביניים שסופקו כדי למזער את העלות הכוללת של המסלול. אם נקודות הציון עברו אופטימיזציה, צריך לבדוק את DirectionsRoute.waypoint_order בתשובה כדי לראות את הסדר החדש.
provideRouteAlternatives optional
סוג:  boolean optional
האם לספק מסלולים חלופיים. אופציונלי.
region optional
סוג:  string optional
קוד אזור שמשמש כהטיה לבקשות לגיאו-קידוד. קוד האזור יכול להיות ccTLD (דומיין ברמה העליונה) באורך שני תווים. רוב קודי ה-ccTLD זהים לקודי ISO 3166-1, אבל יש כמה יוצאים מן הכלל. לדוגמה, דומיין ccTLD של בריטניה הוא uk (.co.uk), אבל קוד ISO 3166-1 שלה הוא gb (מבחינה טכנית, עבור הישות 'ממלכת בריטניה הגדולה וצפון אירלנד').
transitOptions optional
סוג:  TransitOptions optional
הגדרות שחלות רק על בקשות שבהן travelMode הוא TRANSIT. לאובייקט הזה לא תהיה השפעה על אמצעי תחבורה אחרים.
unitSystem optional
סוג:  UnitSystem optional
ברירת מחדל: מערכת היחידות שמשמשת במדינת המקור.
מערכת היחידות המועדפת לשימוש בהצגת מרחק.
waypoints optional
סוג:  Array<DirectionsWaypoint> optional
מערך של נקודות ציון ביניים. ההוראות מחושבות מנקודת המוצא ליעד דרך כל נקודת ציון במערך הזה. ב מדריך למפתחים מפורט המספר המקסימלי של נקודות ציון שאפשר להוסיף. אין תמיכה בציוני דרך במסלולי תחבורה ציבורית. אופציונלי.

DirectionsStatus constants

google.maps.DirectionsStatus constants

הסטטוס שמוחזר על ידי DirectionsService בסיום שיחה אל route(). אפשר לציין אותם לפי ערך או באמצעות שם הקבוע. לדוגמה, 'OK' או google.maps.DirectionsStatus.OK.

אפשר להתקשר אל const {DirectionsStatus} = await google.maps.importLibrary("routes") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.
INVALID_REQUEST הערך DirectionsRequest שסופק לא תקין.
MAX_WAYPOINTS_EXCEEDED צוינו יותר מדי ערכים של DirectionsWaypoint במאפיין DirectionsRequest. ב מדריך למפתחים מפורט המספר המקסימלי של נקודות ציון שאפשר להוסיף.
NOT_FOUND לא ניתן היה לבצע קידוד גיאוגרפי לפחות לאחד מהמקור, היעד או נקודות הביניים.
OK התשובה מכילה DirectionsResult תקין.
OVER_QUERY_LIMIT הדף חרג ממגבלת הבקשות בפרק זמן קצר מדי.
REQUEST_DENIED לדף האינטרנט אין הרשאה להשתמש בשירות ההוראות.
UNKNOWN_ERROR לא ניתן לעבד בקשה להוראות הגעה בגלל שגיאה בשרת. אם תנסו שוב, יכול להיות שהבקשה תצליח.
ZERO_RESULTS לא נמצא מסלול בין נקודת המוצא ליעד.

ממשק DirectionsResult

google.maps.DirectionsResult ממשק

תגובת המסלול שאוחזרה משרת המסלולים. אפשר להציג אותם באמצעות DirectionsRenderer או לנתח את האובייקט הזה ולהציג אותו בעצמכם. עליכם להציג את האזהרות וזכויות היוצרים כפי שמצוין בתנאים ובהגבלות של פלטפורמת מפות Google. הערה: למרות שהתוצאה הזו היא "בסגנון JSON", היא לא JSON במובן המדויק, כי היא כוללת באופן עקיף אובייקטים של LatLng.
request
האובייקט DirectionsRequest שהניב את התוצאה הזו.
routes
מערך של רכיבי DirectionsRoute, שכל אחד מהם מכיל מידע על הקטעים והשלבים שמהם הוא מורכב. יהיה רק מסלול אחד, אלא אם DirectionsRequest נוצר עם provideRouteAlternatives שהוגדר כ-true.
available_travel_modes optional
סוג:  Array<TravelMode> optional
מכיל מערך של אמצעי תחבורה זמינים. השדה הזה מוחזר כשמציינים בבקשה אמצעי תחבורה ולא מתקבלות תוצאות. המערך מכיל את אמצעי התחבורה הזמינים במדינות של קבוצת נקודות הביניים הנתונה. השדה הזה לא מוחזר אם אחת או יותר מנקודות הביניים הן 'נקודות ביניים דרך'.
geocoded_waypoints optional
סוג:  Array<DirectionsGeocodedWaypoint> optional
מערך של אובייקטים מסוג DirectionsGeocodedWaypoint, שכל אחד מהם מכיל מידע על הגיאו-קידוד של נקודת המוצא, היעד ונקודות הביניים.

‫DirectionsRenderer class

google.maps.DirectionsRenderer class

רכיב שמציג מסלולים שהתקבלו מ-DirectionsService.

הכיתה הזו היא הרחבה של MVCObject.

אפשר להתקשר אל const {DirectionsRenderer} = await google.maps.importLibrary("routes") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.
DirectionsRenderer
DirectionsRenderer([opts])
פרמטרים: 
יוצר את רכיב ה-Renderer עם האפשרויות שצוינו. אפשר להציג את ההוראות במפה (כשכבות-על חזותיות) או בנוסף בחלונית <div> (כהוראות טקסטואליות).
getDirections
getDirections()
פרמטרים:  אין
ערך מוחזר:  DirectionsResult
הפונקציה מחזירה את קבוצת הכיוונים הנוכחית של רכיב ה-renderer.
getMap
getMap()
פרמטרים:  אין
ערך מוחזר: