Map View

הכיתה LocalContextMapView

google.maps.localContext.LocalContextMapView class

חוויית משתמש בהקשר מקומי עם Map.

המחלקה הזו מטמיעה את LocalContextMapViewOptions.

אפשר לגשת אליו באמצעות חיוג למספר const {LocalContextMapView} = await google.maps.importLibrary("localContext"). ספריות ב-Maps JavaScript API
LocalContextMapView
LocalContextMapView(options)
פרמטרים: 
directionsOptions
LocalContextMapViewOptions.directionsOptions.
element optional
סוג:  HTMLElement|SVGElement optional
השדה הזה הוא לקריאה בלבד. רכיב ה-DOM שתומך בתצוגה.
isTransitioningMapBounds
סוג:  boolean
מוגדר ל-true לפני ש-LocalContextMapView מתחיל לשנות את הגבולות של Map הפנימי, ומוגדר ל-false אחרי ש-LocalContextMapView מסיים לשנות את הגבולות של Map הפנימי. (לא מוגדר כשיש שינויים במצב הפריסה עקב שינוי גודל רספונסיבי).
locationBias
סוג:  LocationBias optional
LocalContextMapViewOptions.locationBias. שינוי המאפיין הזה ב-LocalContextMapView עשוי להפעיל חיפוש חדש.
locationRestriction
סוג:  LocationRestriction optional
LocalContextMapViewOptions.locationRestriction. שינוי המאפיין הזה ב-LocalContextMapView עשוי להפעיל חיפוש חדש.
maxPlaceCount
סוג:  number
LocalContextMapViewOptions.maxPlaceCount. שינוי המאפיין הזה ב-LocalContextMapView עשוי להפעיל חיפוש חדש.
placeTypePreferences
LocalContextMapViewOptions.placeTypePreferences. שינוי המאפיין הזה ב-LocalContextMapView עשוי להפעיל חיפוש חדש. אפשר להשתמש גם ב-Iterable<string|PlaceTypePreference>.
עובר בירושה: map, pinOptionsSetup, placeChooserViewSetup, placeDetailsViewSetup
addListener
addListener(eventName, handler)
פרמטרים: 
  • eventName:  string
  • handler:  Function
ערך המוחזר:  MapsEventListener
הפונקציה הזו מוסיפה את פונקציית ה-listener שצוינה לשם האירוע שצוין.
hidePlaceDetailsView
hidePlaceDetailsView()
פרמטרים:  ללא
ערך המוחזר:  None
הסתרת פרטי המקום.
search
search()
פרמטרים:  ללא
ערך המוחזר:  None
חיפוש מקומות להצגה למשתמש על סמך הערכים הנוכחיים של maxPlaceCount, placeTypePreferences, locationRestriction ו-locationBias.
error
function(event)
ארגומנטים: 
האירוע הזה מופעל אם יש שגיאה במהלך ביצוע החיפוש.
placedetailsviewhidestart
function()
ארגומנטים:  None
האירוע הזה מופעל לפני שנעשית אנימציה של היציאה של פרטי המקום.
placedetailsviewshowstart
function()
ארגומנטים:  None
האירוע הזה מופעל לפני שפרטי המקום מתחילים להופיע באנימציה.

ממשק LocalContextMapViewOptions

ממשק google.maps.localContext.LocalContextMapViewOptions

אפשרויות ליצירת LocalContextMapView או לגישה ל-LocalContextMapView קיים.
maxPlaceCount
סוג:  number
המספר המקסימלי של מקומות שאפשר להציג. כשהערך של הפרמטר הזה הוא 0, ספריית ההקשר המקומי לא טוענת מקומות. [0,24]
placeTypePreferences
סוגי המקומות לחיפוש (עד 10). אפשר גם להשתמש בסוג Iterable<string|PlaceTypePreference>, אבל הוא נתמך רק בדפדפנים שתומכים באופן מקורי בסמלי JavaScript.
directionsOptions optional
אפשרויות להתאמה אישית של מסלולים. אם לא תגדירו את ההגדרה הזו, ההנחיות והמרחק יושבתו.
element optional
סוג:  HTMLElement|SVGElement optional
השדה הזה הוא לקריאה בלבד. רכיב ה-DOM שתומך בתצוגה.
locationBias optional
סוג:  LocationBias optional
ברירת מחדל: null
גבול או רמז רופפים לשימוש בחיפוש מקומות.
locationRestriction optional
סוג:  LocationRestriction optional
גבולות כדי להגביל את תוצאות החיפוש. אם לא מציינים את הערך, התוצאות יוגבלו למסך המפה.
map optional
סוג:  Map optional
מופע Map שכבר נוצר. אם מעבירים את המפה, היא תועבר ל-DOM של LocalContextMapView, ולא יותאם לה סגנון מחדש. יכול להיות שגם לרכיב שמשויך למפה יוחלו סגנונות וסיווגים על ידי LocalContextMapView.
pinOptionsSetup optional
סוג:  (function({
  isSelected:boolean,
  isHighlighted:boolean
}): (PinOptions optional))|PinOptions optional
מגדירים את סמל סמן המיקום על סמך מצב הסמל. הפונקציה מופעלת בכל פעם שהקלט של קריאת החזרה (callback) משתנה. מעבירים פונקציה כדי לשנות באופן דינמי את הגדרת ברירת המחדל כש-LocalContextMapView מצייר את סמן המיקום. יכול להיות שהמערכת תזהה שגיאות והגדרות לא חוקיות באופן אסינכרוני, והן יידחו (המערכת תשתמש בברירת המחדל והשגיאות ירשמו ביומן במסוף).
placeChooserViewSetup optional
סוג:  (function({
  defaultLayoutMode:PlaceChooserLayoutMode,
  defaultPosition:PlaceChooserPosition optional
}): (PlaceChooserViewSetupOptions optional))|PlaceChooserViewSetupOptions optional
משנה את ההגדרה של תצוגת הכלי לבחירת מקום. מעבירים פונקציה כדי לשנות באופן דינמי את הגדרת ברירת המחדל כשיכול להיות שפריסת LocalContextMapView תשתנה בגלל שינוי בגודל. יכול להיות שהמערכת תזהה שגיאות והגדרות לא חוקיות באופן אסינכרוני, והן יידחו (במקום זאת, המערכת תשתמש בהגדרות ברירת המחדל והשגיאות ירשמו ביומן במסוף). שגיאות שזוהו במהלך היצירה יגרמו להשלכת שגיאות באופן סינכרוני.
placeDetailsViewSetup optional
סוג:  (function({
  defaultLayoutMode:PlaceDetailsLayoutMode,
  defaultPosition:PlaceDetailsPosition optional
}): (PlaceDetailsViewSetupOptions optional))|PlaceDetailsViewSetupOptions optional
משנה את ההגדרה של תצוגת פרטי המקום. מעבירים פונקציה כדי לשנות באופן דינמי את הגדרת ברירת המחדל כשיכול להיות שפריסת LocalContextMapView תשתנה בגלל שינוי בגודל. יכול להיות שהמערכת תזהה שגיאות והגדרות לא חוקיות באופן אסינכרוני, והן יידחו (המערכת תשתמש בברירת המחדל והשגיאות ירשמו ביומן במסוף). שגיאות שזוהו במהלך היצירה יגרמו להשלכת שגיאות באופן סינכרוני.

PlaceTypePreference typedef

google.maps.localContext.PlaceTypePreference typedef

סוג המקום לחיפוש והמשקל שישמש. אם משמיטים את weight, הספרייה תקבע משקלים שמוגדרים כברירת מחדל, שעשויים להשתנות ולהשתפר עם הזמן.

{
  type:string,
  weight:number optional
}

הכיתה MapDirectionsOptions

google.maps.localContext.MapDirectionsOptions class

הגדרות למסלולים עם LocalContextMapView.

המחלקה הזו מטמיעה את MapDirectionsOptionsLiteral.

אפשר לגשת אליו באמצעות חיוג למספר const {MapDirectionsOptions} = await google.maps.importLibrary("localContext"). ספריות ב-Maps JavaScript API
עבר בירושה: origin
addListener
addListener(eventName, handler)
פרמטרים: 
  • eventName:  string
  • handler:  Function
ערך המוחזר:  MapsEventListener
הפונקציה הזו מוסיפה את פונקציית ה-listener שצוינה לשם האירוע שצוין.

הממשק MapDirectionsOptionsLiteral

ממשק google.maps.localContext.MapDirectionsOptionsLiteral

לצורך נוחות, אפשר להשתמש בביטויים לוגיים של אובייקטים במקום באובייקטים מסוג MapDirectionsOptions במקומות רבים. הם מומרים לאובייקטים מסוג MapDirectionsOptions כש-Maps API נתקל בהם.
origin
נקודת המוצא למסלול ולמרחק.

ממשק PinOptions

ממשק google.maps.localContext.PinOptions

אפשרויות להתאמה אישית של סימן סיכה.
background optional
סוג:  string optional
הצבע של צורת הסמל יכול להיות כל צבע חוקי ב-CSS.
glyphColor optional
סוג:  string optional
הצבע של הגליף של הסמל יכול להיות כל צבע חוקי ב-CSS.
scale optional
סוג:  number optional
קנה המידה של הסמל. הערך הוא מוחלט, ולא יחסי לגודלי ברירת המחדל בכל מצב.

הממשק PlaceChooserViewSetupOptions

ממשק google.maps.localContext.PlaceChooserViewSetupOptions

הגדרת האפשרויות לבורר המקומות. מידע נוסף על הגדרת הפריסה והחשיפה
layoutMode optional
סוג:  PlaceChooserLayoutMode optional
position optional
סוג:  PlaceChooserPosition optional
המערכת מתעלמת מהערך הזה כאשר layoutMode:HIDDEN. אם לא מעבירים את הפרמטר הזה, המיקום יקבע באופן אוטומטי על סמך layoutMode.

המשתנים הקבועים של PlaceChooserLayoutMode

google.maps.localContext.PlaceChooserLayoutMode קבועים

מצבי פריסה לבורר המקומות.

אפשר לגשת אליו באמצעות חיוג למספר const {PlaceChooserLayoutMode} = await google.maps.importLibrary("localContext"). ספריות ב-Maps JavaScript API
HIDDEN חלון הבחירה של המיקום מוסתר.
SHEET חלונית הבחירה של המקומות מוצגת כגיליון.

המשתנים הקבועים של PlaceChooserPosition

google.maps.localContext.PlaceChooserPosition קבועים

הצגת המיקומים של בורר המקומות.

אפשר לגשת אליו באמצעות חיוג למספר const {PlaceChooserPosition} = await google.maps.importLibrary("localContext"). ספריות ב-Maps JavaScript API
BLOCK_END בורר המקומות מוצג בשורה מתחת למפה, ומתמשך עד סוף המאגר.
INLINE_END בורר המקומות מוצג בשורה אחת עם המפה, בסוף השורה. (בשפות הנכתבות משמאל לימין, חלון הבחירה של המקומות נמצא מימין למפה).
INLINE_START חלון הבחירה של המיקום מוצג לצד המפה בתחילת השורה. (בשפות הנכתבות משמאל לימין, חלון הבחירה של המקומות נמצא בצד ימין של המפה).

הממשק PlaceDetailsViewSetupOptions

ממשק google.maps.localContext.PlaceDetailsViewSetupOptions

אפשרויות ההגדרה של פרטי המקום. מידע נוסף על הגדרת הפריסה והחשיפה
hidesOnMapClick optional
סוג:  boolean optional
layoutMode optional
סוג:  PlaceDetailsLayoutMode optional
position optional
סוג:  PlaceDetailsPosition optional
המערכת מתעלמת מהערך הזה כאשר layoutMode:INFO_WINDOW. אם לא מעבירים את הפרמטר הזה, המיקום יקבע באופן אוטומטי על סמך layoutMode.

המשתנים הקבועים של PlaceDetailsLayoutMode

google.maps.localContext.PlaceDetailsLayoutMode קבועים

מצבי פריסה של פרטי המקום.

אפשר לגשת אליו באמצעות חיוג למספר const {PlaceDetailsLayoutMode} = await google.maps.importLibrary("localContext"). ספריות ב-Maps JavaScript API
INFO_WINDOW פרטי המקום מוצגים ב-InfoWindow.
SHEET פרטי המקום מוצגים בגיליון.

קבועים של PlaceDetailsPosition

google.maps.localContext.PlaceDetailsPosition קבועים

מיקומי התצוגה של פרטי המקום.

אפשר לגשת אליו באמצעות חיוג למספר const {PlaceDetailsPosition} = await google.maps.importLibrary("localContext"). ספריות ב-Maps JavaScript API
INLINE_END פרטי המקום מוצגים בשורה עם המפה, בסוף השורה. (בשפות הנכתבות משמאל לימין, פרטי המקום מופיעים מימין למפה).
INLINE_START פרטי המקום מוצגים בשורה עם המפה בתחילת השורה. (בשפות הנכתבות משמאל לימין, פרטי המקום מופיעים משמאל למפה).