Directions

שיעור במסלול השירות

מחלקה google.maps.DirectionsService

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

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

הממשק של מסלול הבקשות

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

קבועים למסלול סטטוס

google.maps.DirectionsStatus קבועים

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

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

ממשק מסלול התוצאות

ממשק google.maps.DirectionsResult

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

שיעור ב-DIRECTIONRenderer

מחלקה google.maps.DirectionsRenderer

רינדור מסלולים שהתקבלו מהמסמך DirectionsService.

השיעור הזה נמשך MVCObject.

אפשר לקבל גישה על ידי התקשרות ל-const {DirectionsRenderer} = await google.maps.importLibrary("routes"). יש לעיין בספריות ב-API של מפות Google ל-JavaScript.
DirectionsRenderer
DirectionsRenderer([opts])
פרמטרים: 
יוצר את כלי הרינדור עם האפשרויות הנתונים. ניתן להציג מסלול במפה (כשכבות-על ויזואליות) או גם בחלונית <div> (כהוראות טקסט).
getDirections
getDirections()
פרמטרים: ללא
ערך החזרה:  DirectionsResult
מחזירה את קבוצת המסלולים הנוכחית של הרינדור.
getMap
getMap()
פרמטרים: ללא
ערך החזרה:  Map
מחזירה את המפה שבה מוצג ה-DirectionsResult.
getPanel
getPanel()
פרמטרים: ללא
ערך החזרה:  HTMLElement|null
מחזירה את הלוח <div> שבו מעובד ה-DirectionsResult.
getRouteIndex
getRouteIndex()
פרמטרים: ללא
ערך החזרה:  number
מחזירה את אינדקס הנתיב הנוכחי (מבוסס אפס) שנמצא בשימוש על ידי אובייקט DirectionsRenderer זה.
setDirections
setDirections(directions)
פרמטרים: 
ערך החזרה: ללא
אפשר להגדיר את הרינדור באמצעות התוצאה מ-DirectionsService. הגדרת קבוצה חוקית של הוראות מסלול באופן זה תציג את המסלול במפה ובלוח הייעודיים של כלי הרינדור.
setMap
setMap(map)
פרמטרים: 
ערך החזרה: ללא
שיטה זו מציינת את המפה שבה יוצגו העיבודים. עוברים על פני null כדי להסיר את המסלול מהמפה.
setOptions
setOptions(options)
פרמטרים: 
ערך החזרה: ללא
עליך לשנות את הגדרות האפשרויות של DirectionsRenderer זה לאחר האתחול.
setPanel
setPanel(panel)
פרמטרים: 
ערך החזרה: ללא
שיטה זו מעבדת את המסלול ב-<div>. עוברים על פי null כדי להסיר את התוכן מהחלונית.
setRouteIndex
setRouteIndex(routeIndex)
פרמטרים: 
  • routeIndex:  number
ערך החזרה: ללא
כדי לעבד את האינדקס, מבוסס על אפס (מבוסס אפס) על הנתיב באובייקט DirectionsResult. כברירת מחדל, יוצג המסלול הראשון במערך.
עברו בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
directions_changed
function()
ארגומנטים: ללא
האירוע הזה מופעל כשמסלול העיבוד משתנה, בין אם מוגדר DirectionsResult חדש או כשהמשתמש גורר שינוי לנתיב המסלול.

הממשק של כיוונים לעיבוד

ממשק google.maps.DirectionsRendererOptions

האובייקט הזה מגדיר את המאפיינים שאפשר להגדיר באובייקט DirectionsRenderer.
directions optional
סוג:  DirectionsResult optional
המסלול שמוצג במפה ו/או בחלונית <div>, אוחזר כאובייקט DirectionsResult מ-DirectionsService.
draggable optional
סוג:  boolean optional
אם המדיניות true מופעלת, המשתמש יכול לגרור ולשנות את נתיבי הנתיבים שעובדו על ידי DirectionsRenderer.
hideRouteList optional
סוג:  boolean optional
ברירת מחדל: false
המאפיין הזה מציין אם כלי הרינדור צריך לספק רשימת מסלולים לבחירה של המשתמש שמוצגים בחלונית המסלול.
infoWindow optional
סוג:  InfoWindow optional
InfoWindow שבו יש לעבד פרטי טקסט כאשר לוחצים על סמן. התוכן של חלון המידע הקיים יוחלף והתוכן של המיקום יועבר. אם לא מציינים חלון מידע, מערכת DirectionsRenderer יוצרת חלון מידע ומשתמשת בו. אם המאפיין suppressInfoWindows יוגדר כ-true, המערכת תתעלם מהנכס הזה.
map optional
סוג:  Map optional
המפה שבה יוצג המסלול.
markerOptions optional
סוג:  MarkerOptions optional
אפשרויות לסמנים. כל הסמנים שעובדו על ידי DirectionsRenderer ישתמשו באפשרויות אלה.
panel optional
סוג:  HTMLElement optional
<div> להצגת השלבים במסלול.
polylineOptions optional
סוג:  PolylineOptions optional
אפשרויות לקווים הרבים. בכל קווי המצולע המעובדים על ידי DirectionsRenderer ייעשה שימוש באפשרויות האלה.
preserveViewport optional
סוג:  boolean optional
ברירת מחדל: false
אם האפשרות הזו מוגדרת כ-true או שהמרכז או המרחק מהתצוגה של המפה מעולם לא הוגדרו, מפת הקלט ממורכזת והתקרבה לתיבה התוחמת של קבוצת ההנחיות הזו.
routeIndex optional
סוג:  number optional
מספר האינדקס של המסלול בתוך האובייקט DirectionsResult. ערך ברירת המחדל הוא 0.
suppressBicyclingLayer optional
סוג:  boolean optional
הסתר את העיבוד של ה-BicyclingLayer כאשר מבקשים מסלולי רכיבה על אופניים.
suppressInfoWindows optional
סוג:  boolean optional
למנוע רינדור של חלונות מידע.
suppressMarkers optional
סוג:  boolean optional
למנוע רינדור של סמנים.
suppressPolylines optional
סוג:  boolean optional
ביטול ההצגה של קווים מרובים.

ממשק כיוונים

ממשק google.maps.DirectionsWaypoint

DirectionsWaypoint מייצג מיקום בין נקודת המוצא ליעד שאליו ברצונך לנתב את הנסיעה.
location optional
סוג:  string|LatLng|LatLngLiteral|Place optional
מיקום ציון דרך. הערך יכול להיות מחרוזת כתובת, LatLng או Place. אופציונלי.
stopover optional
סוג:  boolean optional
ברירת מחדל: true
אם השדה true מציין שנקודת הציון הזו היא עצירה בין המוצא ליעד. כתוצאה מכך, ניתן לפצל את הנתיב לשתי רגליים. אם השדה false מציין שהנתיב חייב להיות נטוי כדי לעבור דרך ציון דרך זה, אך לא לפצל אותו לשני רגליים. פעולה זו שימושית אם ברצונך ליצור נתיב בתגובה לציוני הדרך שהמשתמש גורר במפה.

הממשק של כיוונים גיאוגרפיים קוד וואי

ממשק google.maps.DirectionsGeocodedWaypoint

ציון דרך יחיד עם קידוד גיאוגרפי.
partial_match optional
סוג:  boolean optional
מציין אם ה-מקודד לא החזיר התאמה מדויקת לנקודת הציון המקורית, למרות שהוא הצליח להתאים לחלק מהכתובת המבוקשת.
place_id optional
סוג:  string optional
מזהה המקום שמשויך לנקודת הציון. מזהי מקומות מזהים באופן ייחודי מקום במסד הנתונים של מקומות Google ובמפות Google. מידע נוסף על מזהי מקומות זמין במדריך למפתחים על מקומות ב-API.
types optional
סוג:  Array<string> optional
מערך מחרוזות המציינות את סוג הרכיב המקודד שהתקבל. רשימה של מחרוזות אפשריות זמינה בקטע סוגי רכיבים בכתובת במדריך למפתחים.

המסלול מסלול

ממשק google.maps.DirectionsRoute

נתיב יחיד המכיל קבוצת רגליים בתוך DirectionsResult. חשוב לשים לב שהאובייקט הזה הוא כמו "JSON", אבל הוא לא JSON בלבד כי הוא כולל אובייקטים של LatLng באופן ישיר ועקיף.
bounds
סוג:  LatLngBounds
הגבולות של המסלול הזה.
copyrights
סוג:  string
טקסט זכויות יוצרים שיוצג במסלול הזה.
legs
סוג:  Array<DirectionsLeg>
מערך של DirectionsLeg, שבכל אחד מהן יש מידע על השלבים שהוא מורכב ממנו. יהיה רגל אחת לכל נקודת ציון או יעד של עצירות ביניים. כך, מסלול ללא נקודות ציון של עצירה יכלול DirectionsLeg אחד ונתיב עם נקודת עצירה אחת יכלול שתי נקודות.
overview_path
סוג:  Array<LatLng>
מערך של LatLng שמייצג/ת את כל המסלול הזה. הנתיב פשוט יותר כדי שיהיה מתאים בהקשרים שבהם נדרש מספר קטן של קודקודים (כגון כתובות אתר של Static Maps API).
overview_polyline
סוג:  string
ייצוג רב-קו מקודד של הנתיב ב-overview_path. קו מרובה נקודות זה הוא נתיב משוער (חלק) של המסלול שמתקבל.
summary
סוג:  string
הטקסט כולל תיאור טקסט קצר של המסלול, שמתאים למתן שמות ולמתן מידע ברור על המסלול מהחלופות.
warnings
סוג:  Array<string>
הצגת אזהרות עם הצגת המסלול הזה.
waypoint_order
סוג:  Array<number>
אם השדה optimizeWaypoints היה true, השדה הזה יכיל את הסידור מחדש של ציוני הדרך שהוזנו. לדוגמה, אם הקלט היה:
מקור: לוס אנג'לס
ציוני דרך: דאלאס, באנגור, פניקס
יעד: ניו יורק
והפלט האופטימלי עבר כך:
מקור: לוס אנג'לס
ציוני דרך: פניקס, דאלאס, בנגור
יעד: ניו יורק
, השדה הזה יהיה [Array, המכיל את הערכים ] שימו לב שהמספור של ציוני דרך מבוסס על אפסים.
אם אחד מציוני הדרך של הקלט stopover מוגדר ל-false, שדה זה יהיה ריק, מאחר שאופטימיזציית הנתיב אינה זמינה עבור שאילתות כאלה.
fare optional
סוג:  TransitFare optional
המחיר הכולל לנסיעה כולה. רלוונטי רק לבקשות של תחבורה ציבורית.

ממשק כיוונים

ממשק google.maps.DirectionsLeg

רגל אחת שמורכבת מקבוצת צעדים ב-DirectionsResult. ייתכן שחלק מהשדות שבשוק לא יוחזרו לכל הבקשות. חשוב לשים לב שהתוצאה הזו היא כמו "JSON", אבל היא לא JSON בלבד כי היא כוללת אובייקטים של LatLng באופן ישיר ועקיף.
end_address
סוג:  string
כתובת היעד של הרגל הזו. תוכן זה נועד לקריאה כפי שהוא. אין לנתח באופן פרוגרמטי את הכתובת המפורמטת.
end_location
סוג:  LatLng
הפונקציה DirectionsService מחשבת מסלול בין מיקומים באמצעות אפשרות התחבורה הקרובה ביותר (בדרך כלל בדרך) בנקודות ההתחלה והסיום. end_location מציין את היעד המקודד בפועל, שיכול להיות שונה מ-end_location של השלב האחרון אם, לדוגמה, הדרך לא קרובה ליעד של הרגל הזו.
start_address
סוג:  string
כתובת המקור של הרגל הזו. תוכן זה נועד לקריאה כפי שהוא. אין לנתח באופן פרוגרמטי את הכתובת המפורמטת.
start_location
סוג:  LatLng
הפונקציה DirectionsService מחשבת מסלול בין מיקומים באמצעות אפשרות התחבורה הקרובה ביותר (בדרך כלל בדרך) בנקודות ההתחלה והסיום. start_location מציין את המקור האמיתי של האזור המקודד, שעשוי להיות שונה מ-start_location של השלב הראשון אם, לדוגמה, הדרך אינה קרובה למקור של רגל זו.
steps
מערך של DirectionsStep, שכל אחד מהם מכיל מידע לגבי השלבים השונים בחלק הזה.
traffic_speed_entry
סוג:  Array<?>
מידע על מהירות התנועה לאורך המסלול.
via_waypoints
סוג:  Array<LatLng>
מערך של נקודות ציון ללא הפסקה לאורך הקטע הזה, שצוינו בבקשה המקורית.

הוצא משימוש במסלולים חלופיים. גרסה 3.27 תהיה הגרסה האחרונה של ה-API שמוסיפה עוד via_waypoints למסלולים חלופיים.

בעת שימוש בשירות המסלול כדי ליישם מסלולים שניתנים לגרירה, מומלץ להשבית גרירה של מסלולים חלופיים. אפשר לגרור רק את המסלול הראשי. המשתמשים יכולים לגרור את המסלול הראשי עד שיתאים למסלול החלופי.
arrival_time optional
סוג:  Time optional
זמן הגעה משוער לקטע הזה. רלוונטי רק לבקשות TRANSIT.
departure_time optional
סוג:  Time optional
זמן יציאה משוער בשביל החלק הזה. רלוונטי רק לבקשות TRANSIT.
distance optional
סוג:  Distance optional
המרחק הכולל שמכוסים על ידי הרגל הזו. ייתכן שהנכס לא מוגדר כי ייתכן שהמרחק לא ידוע.
duration optional
סוג:  Duration optional
משך הזמן הכולל של הקטע הזה. הנכס הזה עשוי להיות undefined כי משך הזמן לא ידוע.
duration_in_traffic optional
סוג:  Duration optional
משך הזמן הכולל של הקטע הזה תוך התחשבות במצב התנועה שצוין בנכס trafficModel. הנכס הזה עשוי להיות undefined כי משך הזמן לא ידוע.

הממשק של כיוונים

ממשק google.maps.DirectionsStep

DirectionsStep אחד ב-DirectionsResult. ייתכן שחלק מהשדות יהיו undefined. חשוב לשים לב שהאובייקט הזה הוא כמו "JSON", אבל הוא לא JSON בדיוק כי הוא כולל ישירות אובייקטים של LatLng.
encoded_lat_lngs
סוג:  string
ייצוג רב-קו מקודד של השלב. זהו נתיב משוער (חלק) של השלב.
end_location
סוג:  LatLng
מיקום הסיום של השלב הזה.
end_point
סוג:  LatLng
מיקום הסיום של השלב הזה.
instructions
סוג:  string
הוראות לשלב הזה.
lat_lngs
סוג:  Array<LatLng>
רצף של LatLng שניות שמתאר את מהלך השלב הזה. זהו נתיב משוער (חלק) של השלב.
maneuver
סוג:  string
מכילה את הפעולה לביצוע בשלב הנוכחי (turn-left, merge, straight וכו'). הערכים עשויים להשתנות, וייתכן שיוצגו ערכים חדשים ללא הודעה מראש.
path
סוג:  Array<LatLng>
רצף של LatLng שניות שמתאר את מהלך השלב הזה. זהו נתיב משוער (חלק) של השלב.
start_location
סוג:  LatLng
מיקום ההתחלה של השלב הזה.
start_point
סוג:  LatLng
מיקום ההתחלה של השלב הזה.
travel_mode
סוג:  TravelMode
אמצעי התחבורה שמשויך לשלב הזה.
distance optional
סוג:  Distance optional
המרחק ששלב זה מכסה. הנכס הזה עשוי להיות undefined כי ייתכן שהמרחק לא ידוע.
duration optional
סוג:  Duration optional
הזמן הטיפוסי שנדרש כדי לבצע את השלב הזה בשניות ובטקסט. הנכס הזה עשוי להיות undefined כי משך הזמן לא ידוע.
polyline optional
סוג:  DirectionsPolyline optional
מכיל אובייקט עם מאפיין יחיד בשם 'points', שמכיל ייצוג מצולע מקודד של השלב. הקו הזה הוא נתיב משוער (חלק) של השלב.
steps optional
סוג:  Array<DirectionsStep> optional
שלבי המשנה של השלב הזה. האפשרות הזו מיועדת לקטעים שאינם של תחבורה ציבורית בנתיבי תחבורה ציבורית.
transit optional
סוג:  TransitDetails optional
פרטים ספציפיים לתחבורה הציבורית בנוגע לשלב הזה. הנכס הזה לא יוגדר אלא אם אמצעי התחבורה של השלב הזה הוא TRANSIT.
transit_details optional
סוג:  TransitDetails optional
פרטים הקשורים לשלב הזה אם אמצעי התחבורה הוא TRANSIT.

ממשק המסלול

ממשק google.maps.DirectionsPolyline

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

ממשקמיקום

ממשק google.maps.Place

מכיל מידע הנחוץ כדי למצוא, לזהות או לתאר מקום עבור DirectionsRequest או DistanceMatrixRequest. בהקשר זה, 'מקום' פירושו עסק, נקודת עניין או מיקום גיאוגרפי. כדי לקבל מידע על מקום מסוים, אפשר לקרוא את המאמר PlacesService.
location optional
סוג:  LatLng|LatLngLiteral optional
LatLng של הישות המתוארת על ידי מקום זה.
placeId optional
סוג:  string optional
המזהה של המקום (למשל, עסק או נקודת עניין). מזהה המקום הוא מזהה ייחודי של מקום במסד הנתונים של מפות Google. הערה: placeId היא הדרך המדויקת ביותר לזהות מקום. אם אפשר, צריך לציין placeId ולא query. ניתן לאחזר מזהה מקום מכל בקשה ל-API של 'מקומות', כמו למשל TextSearch. ניתן לאחזר מזהי מקומות גם מבקשות ל-API לקידוד גיאוגרפי. מידע נוסף זמין בסקירה הכללית בנושא מזהי מקומות.
query optional
סוג:  string optional
שאילתת חיפוש המתארת את המקום (כגון עסק או נקודת עניין). שאילתה לדוגמה: "Quay, Upper Level, Overseas Passenger Terminal 5 Hickson Road, The Rocks NSW". אם אפשר, צריך לציין placeId ולא query. ה-API לא מבטיח שהנתונים שמוצגים במחרוזת השאילתה יהיו מדויקים. אם placeId וגם query סופקו, תופיע הודעת שגיאה.

קבועים של TravelMode

google.maps.TravelMode קבועים

מצבי הנסיעה התקינים שניתן לציין בDirectionsRequest וגם מצבי הנסיעה שמוחזרים ב-DirectionsStep. צריך לציין את הערכים האלה לפי ערך, או להשתמש בשם הקבוע. לדוגמה, 'BICYCLING' או google.maps.TravelMode.BICYCLING.

אפשר לקבל גישה על ידי התקשרות ל-const {TravelMode} = await google.maps.importLibrary("routes"). יש לעיין בספריות ב-API של מפות Google ל-JavaScript.
BICYCLING מציינת בקשת מסלול רכיבה על אופניים.
DRIVING מציינת בקשה לקבלת מסלול נסיעה.
TRANSIT מציינת בקשה לקבלת מסלול לתחבורה ציבורית.
WALKING מציינת בקשה לקבלת מסלול הליכה.

ממשק אפשרויות האפשרויות

ממשק google.maps.DrivingOptions

המדיניות הזו מגדירה את DirectionsRequest כשמצב הנסיעה מוגדר ל-DRIVING.
departureTime
סוג:  Date
זמן היציאה הרצוי למסלול, שצוין כאובייקט Date. האובייקט של Date מודד את משך הזמן באלפיות השנייה מאז 1 בינואר 1970. יש לציין זאת כדי ש-DrivingOptions יהיה חוקי. שעת היציאה צריכה להיות בזמן הנוכחי או בזמן עתידי. התאריך לא יכול להיות בעבר.
trafficModel optional
סוג:  TrafficModel optional
ההנחה המועדפת לשימוש בחיזוי משך התנועה. ברירת המחדל היא BEST_GUESS.

קבועים של TrafficModel

google.maps.TrafficModel קבועים

ההנחות שבהן יש להשתמש בעת חיזוי משך התנועה. הנתונים שצוינו כחלק מ-DirectionsRequest או DistanceMatrixRequest. צריך לציין את הערכים האלה לפי ערך, או להשתמש בשם הקבוע. לדוגמה, 'bestguess' או google.maps.TrafficModel.BEST_GUESS.

אפשר לקבל גישה על ידי התקשרות ל-const {TrafficModel} = await google.maps.importLibrary("routes"). יש לעיין בספריות ב-API של מפות Google ל-JavaScript.
BEST_GUESS אפשר להשתמש בנתונים היסטוריים של תנועת הגולשים כדי להעריך בצורה הטובה ביותר את משך התנועה.
OPTIMISTIC השתמשו בנתוני תנועה היסטוריים כדי לספק הערכה אופטימית לגבי משך התנועה.
PESSIMISTIC השתמשו בנתוני תנועה היסטוריים כדי להעריך באופן חיובי את משך התנועה.

הממשק של אפשרויות התחבורה הציבורית

ממשק google.maps.TransitOptions

כדי לכלול את האובייקט Transit Transit בתוך DirectionsRequest כאשר מצב הנסיעה מוגדר ל-TRANSIT.
arrivalTime optional
סוג:  Date optional
שעת ההגעה הרצויה למסלול, שצוינה כאובייקט תאריך. אובייקט התאריך מודד את משך הזמן באלפיות השנייה מאז 1 בינואר 1970. אם זמן ההגעה צוין, המערכת מתעלמת משעת היציאה.
departureTime optional
סוג:  Date optional
זמן היציאה הרצוי למסלול, שצוין כאובייקט תאריך. אובייקט התאריך מודד את משך הזמן באלפיות השנייה מאז 1 בינואר 1970. אם לא צוינה שעת יציאה או שעת הגעה, ההנחה היא שהשעה היא 'עכשיו'.
modes optional
סוג:  Array<TransitMode> optional
אמצעי תחבורה מועדף אחד או יותר, כמו אוטובוס או רכבת. אם לא תינתן העדפה, ה-API יחזיר את נתיב ברירת המחדל.
routingPreference optional
סוג:  TransitRoutePreference optional
העדפה שיכולה להשמיט את הבחירה של מסלול התחבורה הציבורית, כמו פחות הליכה. אם לא תינתן העדפה, ה-API יחזיר את נתיב ברירת המחדל.

מצב תחבורה ציבורית קבועים

google.maps.TransitMode קבועים

מצב תחבורה ציבורית תקין, למשל, שאותו אפשר לציין ב-TransitOptions. צריך לציין את הערכים האלה לפי ערך, או להשתמש בשם הקבוע. לדוגמה, 'BUS' או google.maps.TransitMode.BUS.

אפשר לקבל גישה על ידי התקשרות ל-const {TransitMode} = await google.maps.importLibrary("routes"). יש לעיין בספריות ב-API של מפות Google ל-JavaScript.
BUS הגדרת האוטובוס כאמצעי תחבורה מועדף.
RAIL מציין רכבת כאמצעי תחבורה מועדף.
SUBWAY מציין רכבת תחתית כאמצעי תחבורה מועדף.
TRAIN מציין רכבת כאמצעי תחבורה מועדף.
TRAM מציין חשמלית כאמצעי תחבורה מועדף.

קבועים ל-TransportRoutePreferences

google.maps.TransitRoutePreference קבועים

סוג נתיב התחבורה הציבורית החוקי שניתן לציין ב-TransitOptions. צריך לציין את הערכים האלה לפי ערך, או להשתמש בשם הקבוע. לדוגמה, 'LESS_WALKING' או google.maps.TransitRoutePreference.LESS_WALKING.

אפשר לקבל גישה על ידי התקשרות ל-const {TransitRoutePreference} = await google.maps.importLibrary("routes"). יש לעיין בספריות ב-API של מפות Google ל-JavaScript.
FEWER_TRANSFERS מציינת שהמסלול המחושב צריך להעדיף מספר מוגבל של העברות.
LESS_WALKING מציינת שהמסלול המחושב צריך להעדיף כמויות מוגבלות של הליכה.

הממשק של TransportFare

ממשק google.maps.TransitFare

תעריף של DirectionsRoute שכולל את הערך והמטבע.
currency
סוג:  string
קוד מטבע בתקן ISO 4217 שמציין את המטבע שבו מבטאים את המחירים.
value
סוג:  number
הערך המספרי של המחיר, המבוטא ב-currency הנתון.

הממשק של transitDetails

ממשק google.maps.TransitDetails

פרטים על היציאה, ההגעה ומצב התחבורה הציבורית שבהם נעשה שימוש בשלב זה.
arrival_stop
סוג:  TransitStop
תחנת ההגעה של שלב התחבורה הציבורית הזה.
arrival_time
סוג:  Time
שעת ההגעה לשלב הזה, כאובייקט זמן.
departure_stop
סוג:  TransitStop
תחנת היציאה של שלב התחבורה הציבורית הזה.
departure_time
סוג:  Time
זמן היציאה של השלב הזה, כמוגדר כאובייקט זמן.
headsign
סוג:  string
הכיוון שבו נוסעים על הקו הזה, כפי שהוא מסומן ברכב או בשעת ההמראה.
headway
סוג:  number
מספר השניות הצפוי בין כלי רכב מקבילים בתחנה הזו.
line
סוג:  TransitLine
פרטים על קו התחבורה הציבורית המשמש בשלב זה.
num_stops
סוג:  number
מספר העצירות בשלב הזה. העלות כוללת את שעת ההגעה, אבל לא את שעת היציאה.
trip_short_name
סוג:  string
הטקסט שמופיע בלוחות הזמנים ובשלטי החוצות כדי לזהות נסיעה בתחבורה ציבורית לנוסעים, לדוגמה, כדי לזהות מספרי רכבות של נסיעות ברכבת. הטקסט מזהה נסיעה באופן ייחודי בתוך יום שירות.

הממשק של transitStop

ממשק google.maps.TransitStop

פרטים על תחנה של תחבורה ציבורית או על תחנה של תחבורה ציבורית.
location
סוג:  LatLng
המיקום של התחנה הזו.
name
סוג:  string
השם של תחנת התחבורה הציבורית הזו.

ממשק transitLine

ממשק google.maps.TransitLine

מידע על קו התחבורה הציבורית שמפעיל את השלב הזה בתחבורה הציבורית.
agencies
סוג:  Array<TransitAgency>
חברת התחבורה הציבורית שמפעילה את קו התחבורה הציבורית.
color
סוג:  string
הצבע שמשמש בדרך כלל לשילוט של הקו הזה, והוא מיוצג כמחרוזת הקסדצימלית.
icon
סוג:  string
כתובת ה-URL של סמל המשויך לשורה זו.
name
סוג:  string
השם המלא של קו התחבורה הציבורית הזה, לדוגמה "8 Street Local".
short_name
סוג:  string
השם המקוצר של קו התחבורה הציבורית הזה, לדוגמה "E".
text_color
סוג:  string
צבע הטקסט שמופיע בדרך כלל בשילוט לקווים אלה של תחבורה ציבורית, והוא מיוצג כמחרוזת הקסדצימלית.
url
סוג:  string
כתובת ה-URL של הסוכנות שספציפית לקו התחבורה הציבורית הזה.
vehicle
סוג:  TransitVehicle
סוג הרכב שנעשה בו שימוש, למשל רכבת או אוטובוס.

ממשק Agency

ממשק google.maps.TransitAgency

מידע על סוכנות שיש בה קו תחבורה ציבורית.
name
סוג:  string
השם של חברת התחבורה הציבורית הזו.
phone
סוג:  string
מספר הטלפון של חברת התחבורה הציבורית.
url
סוג:  string
כתובת ה-URL של חברת התחבורה הציבורית.

ממשק TransportVehicle

ממשק google.maps.TransitVehicle

מידע על הרכב שפועל בקו תחבורה ציבורית.
icon
סוג:  string
כתובת URL של סמל שתואם לסוג הרכב שנמצא בשימוש בקו הזה.
local_icon
סוג:  string
כתובת URL של סמל שתואם לסוג הרכב שנמצא באזור הזה, במקום הסמל הכללי יותר.
name
סוג:  string
שם לסוג הזה של תחבורה ציבורית, כמו "רכבת" או "אוטובוס".
type
סוג:  VehicleType
סוג הרכב שנעשה בו שימוש, למשל רכבת, אוטובוס או מעבורת.

קבועים של VehicleType

google.maps.VehicleType קבועים

ערכים אפשריים לסוגי רכבים.

אפשר לקבל גישה על ידי התקשרות ל-const {VehicleType} = await google.maps.importLibrary("routes"). יש לעיין בספריות ב-API של מפות Google ל-JavaScript.
BUS אוטובוס.
CABLE_CAR כלי רכב שפועל באמצעות כבל, בדרך כלל על האדמה. רכבי אוויר עשויים להיות מסוג GONDOLA_LIFT.
COMMUTER_TRAIN רכבת נוסעים.
FERRY מעבורת.
FUNICULAR רכב שיש לו שיפוע תלול בכבל.
GONDOLA_LIFT רכבל.
HEAVY_RAIL רכבת כבדה.
HIGH_SPEED_TRAIN רכבת מהירה.
INTERCITY_BUS אוטובוס בין-עירוני.
METRO_RAIL רכבת קלה.
MONORAIL רכבת מונורייל.
OTHER כלי רכב אחרים.
RAIL רכבת.
SHARE_TAXI מונית שירות היא סוג של הסעה באוטובוס שיכולים לאסוף נוסעים בתחבורה ציבורית מכל מקום. בדרך כלל מונית נוסעת ברכבי מיניבוס.
SUBWAY רכבת קלה תת-קרקעית.
TRAM מעל רכבת קלה.
TROLLEYBUS טרוליבוס.

קבועים של UnitSystem

google.maps.UnitSystem קבועים

מערכות היחידות התקינות שניתן לציין ב-DirectionsRequest.

אפשר לקבל גישה על ידי התקשרות ל-const {UnitSystem} = await google.maps.importLibrary("core"). יש לעיין בספריות ב-API של מפות Google ל-JavaScript.
IMPERIAL מציינת שמרחקים בDirectionsResult צריכים להתבטא ביחידות אימפריאליות.
METRIC מציינת שמרחקים בDirectionsResult צריכים להתבטא ביחידות של מדדים.

ממשק המרחק

ממשק google.maps.Distance

ייצוג של מרחק כערך מספרי ומחרוזת תצוגה.
text
סוג:  string
ייצוג מחרוזת של ערך המרחק, באמצעות UnitSystem שצוין בבקשה.
value
סוג:  number
המרחק במטרים.

ממשק משך

ממשק google.maps.Duration

ייצוג של משך הזמן כערך מספרי ומחרוזת תצוגה.
text
סוג:  string
ייצוג מחרוזת של ערך משך הזמן.
value
סוג:  number
משך הזמן בשניות.

ממשק זמן

ממשק google.maps.Time

ייצוג של זמן כאובייקט תאריך, מחרוזת המותאמת לאזור זמן ואזור זמן.
text
סוג:  string
מחרוזת המייצגת את ערך הזמן. השעה מוצגת באזור הזמן של תחנת התחבורה הציבורית.
time_zone
סוג:  string
אזור הזמן שבו נעצרת עצירה זו. הערך הוא השם של אזור הזמן כפי שמוגדר במסד הנתונים של אזור הזמן IANA, למשל "America/New_York".
value
סוג:  Date
מועד היציאה או ההגעה, שצוין כאובייקט תאריך JavaScript.

קבועים של DIRECTIONTravelMode

google.maps.DirectionsTravelMode קבועים

קבועים של כיווני יחידות

google.maps.DirectionsUnitSystem קבועים