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()
פרמטרים:  אין
ערך מוחזר:  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)
פרמטרים: 
  • routeIndexnumber
ערך מוחזר:  אין
מגדירים את האינדקס (החל מ-0) של המסלול באובייקט DirectionsResult שיוצג. כברירת מחדל, המסלול הראשון במערך יעבור רינדור.
בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
directions_changed
function()
ארגומנטים:  אין
האירוע הזה מופעל כשמשתנה המסלול שמוצג, או כשמוגדר DirectionsResult חדש או כשהמשתמש מסיים לגרור שינוי במסלול ההוראות.

ממשק DirectionsRendererOptions

google.maps.DirectionsRendererOptions ממשק

האובייקט הזה מגדיר את המאפיינים שאפשר להגדיר באובייקט DirectionsRenderer.

directions optional
סוג:  DirectionsResult optional
המסלול שיוצג במפה או בחלונית <div>, מאוחזר כאובייקט DirectionsResult מ-DirectionsService.
draggable optional
סוג:  boolean optional
אם true, המשתמש יכול לגרור ולשנות את הנתיבים של מסלולים שמוצגים על ידי DirectionsRenderer.
hideRouteList optional
סוג:  boolean optional
ברירת מחדל: false
המאפיין הזה מציין אם רכיב ה-renderer צריך לספק רשימה של מסלולים שמוצגת בחלונית ההוראות, והמשתמש יכול לבחור מתוכה.
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
השבתת העיבוד של קווי פוליגון.

ממשק DirectionsWaypoint

google.maps.DirectionsWaypoint ממשק

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

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

DirectionsGeocodedWaypoint interface

google.maps.DirectionsGeocodedWaypoint ממשק

נקודת ציון אחת עם מיקום גיאוגרפי.

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

ממשק DirectionsRoute

google.maps.DirectionsRoute ממשק

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

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

ממשק DirectionsLeg

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 בנתיבים חלופיים.

כשמשתמשים בשירות Directions כדי להטמיע הוראות דרך שאפשר לגרור, מומלץ להשבית את הגרירה של מסלולים חלופיים. אפשר לגרור רק את המסלול הראשי. המשתמשים יכולים לגרור את המסלול הראשי עד שהוא יתאים למסלול חלופי.

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 כי יכול להיות שהמשך לא ידוע.

ממשק DirectionsStep

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>
רצף של LatLngs שמתאר את מהלך השלב הזה. זהו נתיב משוער (מוחלק) של השלב.
maneuver
סוג:  string
מכיל את הפעולה שיש לבצע בשלב הנוכחי (turn-left, ‏merge, ‏straight וכו'). הערכים עשויים להשתנות, ויכול להיות שיוצגו ערכים חדשים ללא הודעה מוקדמת.
path
סוג:  Array<LatLng>
רצף של LatLngs שמתאר את מהלך השלב הזה. זהו נתיב משוער (מוחלק) של השלב.
start_location
סוג:  LatLng
מיקום ההתחלה של השלב הזה.
start_point
סוג:  LatLng
מיקום ההתחלה של השלב הזה.
travel_mode
סוג:  TravelMode
אמצעי התחבורה שבו נעשה שימוש בשלב הזה.
distance optional
סוג:  Distance optional
המרחק שגומעים בשלב הזה. יכול להיות שהמאפיין הזה יהיה undefined כי יכול להיות שהמרחק לא ידוע.
duration optional
סוג:  Duration optional
הזמן הנדרש בדרך כלל לביצוע השלב הזה, בשניות ובפורמט טקסט. יכול להיות שהערך של המאפיין הזה יהיה undefined כי יכול להיות שהמשך לא ידוע.
polyline optional
סוג:  DirectionsPolyline optional
מכיל אובייקט עם מאפיין יחיד, 'נקודות', שמכיל ייצוג של השלב בקו פוליגוני מקודד. הקו הזה הוא נתיב משוער (מוחלק) של השלב.
steps optional
סוג:  Array<DirectionsStep> optional
שלבי משנה של השלב הזה. הערך הזה מצוין לקטעים של מסלולי תחבורה ציבורית שבהם אין תחבורה ציבורית.
transit optional
סוג:  TransitDetails optional
פרטים ספציפיים לגבי השלב הזה בתחבורה הציבורית. המאפיין הזה לא יוגדר אלא אם אמצעי התחבורה בשלב הזה הוא TRANSIT.
transit_details optional
סוג:  TransitDetails optional
פרטים שקשורים לשלב הזה אם אמצעי התחבורה הוא TRANSIT.

ממשק DirectionsPolyline

google.maps.DirectionsPolyline ממשק

אובייקט שמכיל מאפיין points לתיאור הקו המקוטע של DirectionsStep.

points
סוג:  string

ממשק Place

google.maps.Place ממשק

הוא מכיל מידע שנדרש כדי לאתר, לזהות או לתאר מקום לDirectionsRequest או לDistanceMatrixRequest. בהקשר הזה, 'מקום' הוא עסק, נקודת עניין או מיקום גיאוגרפי. מידע על שליפת נתונים על מקום מסוים זמין במאמר PlacesService.

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

TravelMode constants

google.maps.TravelMode constants

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

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

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

DrivingOptions interface

google.maps.DrivingOptions ממשק

הגדרת DirectionsRequest כשמצב הנסיעה מוגדר לDRIVING.

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

TrafficModel constants

google.maps.TrafficModel constants

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

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

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

TransitOptions interface

google.maps.TransitOptions ממשק

אובייקט TransitOptions שייכלל ב-DirectionsRequest כשמצב הנסיעה מוגדר ל-TRANSIT.

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

TransitMode constants

google.maps.TransitMode constants

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

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

BUS מציין אוטובוס כאמצעי תחבורה מועדף.
RAIL מציין רכבת כאמצעי תחבורה מועדף.
SUBWAY מציין את הרכבת התחתית כאמצעי תחבורה מועדף.
TRAIN מציין רכבת כאמצעי תחבורה מועדף.
TRAM מציין חשמלית כאמצעי תחבורה מועדף.

TransitRoutePreference constants

google.maps.TransitRoutePreference constants

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

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

FEWER_TRANSFERS הגדרה שלפיה המסלול המחושב צריך להעדיף מספר מוגבל של החלפות.
LESS_WALKING הגדרה שקובעת שהמסלול המחושב צריך להעדיף הליכה למרחקים קצרים.

TransitFare interface

google.maps.TransitFare ממשק

מחיר של DirectionsRoute שכולל ערך ומטבע.

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

TransitDetails interface

google.maps.TransitDetails ממשק

פרטים על היציאה, ההגעה ואמצעי התחבורה שבו נעשה שימוש בשלב הזה.

arrival_stop
סוג:  TransitStop
תחנת ההגעה של שלב הנסיעה בתחבורה הציבורית.
arrival_time
סוג:  Time
זמן ההגעה לשלב הזה, שמוגדר כאובייקט Time.
departure_stop
סוג:  TransitStop
תחנת היציאה של שלב התחבורה הציבורית הזה.
departure_time
סוג:  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 Avenue Local'.
short_name
סוג:  string
השם הקצר של קו התחבורה הציבורית הזה, לדוגמה 'E'.
text_color
סוג:  string
צבע הטקסט שמשמש בדרך כלל בשילוט של קו התחבורה הזה, מיוצג כמחרוזת הקסדצימלית.
url
סוג:  string
כתובת ה-URL של הסוכנות שספציפית לקו התחבורה הציבורית הזה.
vehicle
סוג:  TransitVehicle
סוג הרכב שבו משתמשים, למשל רכבת או אוטובוס.

ממשק TransitAgency

google.maps.TransitAgency ממשק

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

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

ממשק TransitVehicle

google.maps.TransitVehicle ממשק

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

icon
סוג:  string
כתובת URL לסמל שמתאים לסוג הרכב שמשמש בקו הזה.
local_icon
סוג:  string
כתובת URL לסמל שמתאים לסוג הרכב שמשמש באזור הזה, במקום לסמל הכללי יותר.
name
סוג:  string
שם לסוג הזה של TransitVehicle, למשל Train או Bus.
type
סוג:  VehicleType
סוג הרכב שבו משתמשים, למשל רכבת, אוטובוס או מעבורת.

VehicleType constants

google.maps.VehicleType constants

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

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

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 constants

google.maps.UnitSystem constants

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

אפשר להתקשר אל const {UnitSystem} = await google.maps.importLibrary("core") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.

IMPERIAL ההגדרה הזו מציינת שהמרחקים ב-DirectionsResult צריכים להיות מוצגים ביחידות מידה אימפריאליות.
METRIC המאפיין הזה מציין שמרחקים ב-DirectionsResult צריכים להיות מוצגים ביחידות מטריות.

ממשק Distance

google.maps.Distance ממשק

ייצוג של מרחק כערך מספרי ומחרוזת לתצוגה.

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

משך הזמן ממשק

google.maps.Duration ממשק

ייצוג של משך זמן כערך מספרי ומחרוזת לתצוגה.

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

ממשק Time

google.maps.Time ממשק

ייצוג של זמן כאובייקט Date, כמחרוזת מקומית וכאזור זמן.

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

DirectionsTravelMode קבועים

google.maps.DirectionsTravelMode constants

DirectionsUnitSystem קבועים

google.maps.DirectionsUnitSystem constants