Map View

מחלקה של LocalContextMapView

google.maps.localContext.LocalContextMapView סיווג

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

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

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

LocalContextMapView
LocalContextMapView(options)
פרמטרים: 
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)
פרמטרים: 
  • eventNamestring
  • handlerFunction
הערך המוחזר:  MapsEventListener
הפונקציה מוסיפה את פונקציית ה-listener שצוינה לשם האירוע הנתון.
hidePlaceDetailsView
hidePlaceDetailsView()
פרמטרים: ללא
ערך החזרה: ללא
הסתרת פרטי המקום.
search
search()
פרמטרים: ללא
ערך החזרה: ללא
חיפוש מקומות להצגה למשתמש על סמך הנתונים הנוכחיים של maxPlaceCount, placeTypePreferences, locationRestriction וlocationBias.
error
function(event)
ארגומנטים: 
האירוע הזה מופעל אם קרתה שגיאה במהלך ביצוע החיפוש.
placedetailsviewhidestart
function()
ארגומנטים: ללא
האירוע הזה מופעל לפני שהאנימציה של פרטי המקום מתחילה.
placedetailsviewshowstart
function()
ארגומנטים: ללא
האירוע הזה מופעל לפני שהאנימציה של פרטי המקום מתחילה.

ממשק 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 סיווג

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

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

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

עברה בירושה: origin
addListener
addListener(eventName, handler)
פרמטרים: 
  • eventNamestring
  • handlerFunction
הערך המוחזר:  MapsEventListener
הפונקציה מוסיפה את פונקציית ה-listener שצוינה לשם האירוע הנתון.

ממשק MapDirectionsOptionsLiteral

ממשק google.maps.localContext.MapDirectionsOptionsLiteral

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

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 פרטי המקום מוצגים בתוך השורה בתחילת הקו. (בשפה משמאל לימין, המשמעות היא שפרטי המקום מופיעים משמאל למפה.)