DirectionsService class
google.maps.DirectionsService
class
שירות לחישוב מסלולים בין שני מקומות או יותר.
אפשר להתקשר אל const {DirectionsService} = await google.maps.importLibrary("routes")
כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.
יצרן | |
---|---|
DirectionsService |
DirectionsService() פרמטרים: אין
יוצר מופע חדש של DirectionsService ששולח שאילתות של הוראות הגעה לשרתים של Google. |
Methods | |
---|---|
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.
Constants | |
---|---|
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 האובייקט DirectionsRequest שהניב את התוצאה הזו. |
routes |
סוג:
Array<DirectionsRoute> מערך של רכיבי 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> (כהוראות טקסטואליות). |
Methods | |
---|---|
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) פרמטרים:
ערך מוחזר: אין
מגדירים את האינדקס (החל מ-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 |
מערך של 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]. שימו לב: המספור של נקודות הציון מבוסס על אפסים.אם לאחת מנקודות הביניים שהוזנו מוגדר הערך stopover false , השדה הזה יהיה ריק, כי אופטימיזציה של מסלולים לא זמינה לשאילתות כאלה. |
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 |
סוג:
Array<DirectionsStep> מערך של רכיבי DirectionsStep , שכל אחד מהם מכיל מידע על השלבים הנפרדים בקטע המסלול הזה. |
|
סוג:
Array<?> מידע על מהירות התנועה לאורך הקטע. |
via_waypoints |
מערך של נקודות ציון ללא עצירה לאורך הקטע הזה, שצוינו בבקשה המקורית. הוצא משימוש במסלולים חלופיים. גרסה 3.27 תהיה הגרסה האחרונה של ה-API שמוסיפה כשמשתמשים בשירות 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 מיקום הסיום של השלב הזה. |
|
סוג:
LatLng מיקום הסיום של השלב הזה. |
instructions |
סוג:
string הוראות לשלב הזה. |
|
רצף של LatLng s שמתאר את מהלך השלב הזה. זהו נתיב משוער (מוחלק) של השלב. |
maneuver |
סוג:
string מכיל את הפעולה שיש לבצע בשלב הנוכחי ( turn-left , merge , straight וכו'). הערכים עשויים להשתנות, ויכול להיות שיוצגו ערכים חדשים ללא הודעה מוקדמת. |
path |
רצף של LatLng s שמתאר את מהלך השלב הזה. זהו נתיב משוער (מוחלק) של השלב. |
start_location |
סוג:
LatLng מיקום ההתחלה של השלב הזה. |
|
סוג:
LatLng מיקום ההתחלה של השלב הזה. |
travel_mode |
סוג:
TravelMode אמצעי התחבורה שבו נעשה שימוש בשלב הזה. |
distance optional |
סוג:
Distance optional המרחק שגומעים בשלב הזה. יכול להיות שהמאפיין הזה יהיה undefined כי יכול להיות שהמרחק לא ידוע. |
duration optional |
סוג:
Duration optional הזמן הנדרש בדרך כלל לביצוע השלב הזה, בשניות ובפורמט טקסט. יכול להיות שהערך של המאפיין הזה יהיה undefined כי יכול להיות שהמשך לא ידוע. |
|
סוג:
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.
Constants | |
---|---|
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.
Constants | |
---|---|
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.
Constants | |
---|---|
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.
Constants | |
---|---|
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.
Constants | |
---|---|
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.
Constants | |
---|---|
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