DOM elements

המחלקה OverlayView

class google.maps.OverlayView extends MVCObject
library "maps", "streetView"

אתם יכולים להטמיע את המחלקה הזו אם אתם רוצים להציג סוגים מותאמים אישית של אובייקטים בשכבת-על במפה.

כדי לרשת מהמחלקה הזו, מגדירים את אב הטיפוס של שכבת-העל: MyOverlay.prototype = new google.maps.OverlayView();. ה-constructor של OverlayView מובטח להיות פונקציה ריקה.

צריך להטמיע שלוש שיטות: onAdd(),‏ draw() ו-onRemove().

  • בשיטה onAdd(), צריך ליצור אובייקטים של DOM ולהוסיף אותם כצאצאים של החלוניות.
  • בשיטה draw(), צריך למקם את הרכיבים האלה.
  • ב-method‏ onRemove(), צריך להסיר את האובייקטים מה-DOM.
צריך להפעיל את setMap() עם אובייקט Map תקין כדי להפעיל את ה-method‏ onAdd(), ואת setMap(null) כדי להפעיל את ה-method‏ onRemove(). אפשר להפעיל את ה-method‏ setMap() בזמן היצירה או בכל שלב אחר כך, כשרוצים להציג מחדש את שכבת-העל אחרי שהיא הוסרה. לאחר מכן, השיטה draw() תיקרא בכל פעם שמאפיין של המפה ישתנה, מה שיכול לשנות את המיקום של הרכיב, כמו מרחק התצוגה, המרכז או סוג המפה.

const {OverlayView} = await google.maps.importLibrary("maps");
 או 
const {OverlayView} = await google.maps.importLibrary("streetView");
OverlayView
OverlayView()
פרמטרים: אין
יצירת OverlayView.
preventMapHitsAndGesturesFrom
preventMapHitsAndGesturesFrom(element)
פרמטרים:
הערך המוחזר: אין
מונע מאירועי קליק, לחיצה, גרירה וגלגלת ברכיב לעבור למפה. אפשר להשתמש באפשרות הזו כדי למנוע גרירה של המפה ושינוי מרחק התצוגה, וגם אירועי "קליק" במפה.
preventMapHitsFrom
preventMapHitsFrom(element)
פרמטרים:
הערך המוחזר: אין
מונעת מהקליק או מהלחיצה על הרכיב לעבור למפה. אפשר להשתמש בזה כדי למנוע מהמפה להפעיל אירועי "קליק".
draw
draw()
פרמטרים: אין
ערך מוחזר: void
מטמיעים את השיטה הזו כדי לצייר או לעדכן את שכבת-העל. משתמשים במיקום מ-projection.fromLatLngToDivPixel() כדי למקם נכון את שכבת-העל ביחס ל-MapPanes. השיטה הזו נקראת אחרי onAdd(), ונקראת כשמשנים את מרכז המפה או את רמת הזום. לא מומלץ לבצע עבודה שדורשת משאבי מחשוב רבים בשיטה הזו.
getMap
getMap()
פרמטרים: אין
ערך מוחזר: Map|StreetViewPanorama|null|undefined
getPanes
getPanes()
פרמטרים: אין
ערך מוחזר: MapPanes|null|undefined
מחזירה את החלוניות שבהן אפשר לעבד את OverlayView. החלוניות לא מאותחלות עד שה-API קורא ל-onAdd.
getProjection
getProjection()
פרמטרים: אין
ערך מוחזר: MapCanvasProjection
מחזירה את האובייקט MapCanvasProjection שמשויך ל-OverlayView הזה. ההיטל לא מאותחל עד שה-API קורא ל-onAdd.
onAdd
onAdd()
פרמטרים: אין
ערך מוחזר: void
צריך להטמיע את השיטה הזו כדי להפעיל את רכיבי ה-DOM של שכבת-העל. השיטה הזו נקראת פעם אחת אחרי ש-setMap()‎ נקראת עם מפה תקינה. בשלב הזה, החלוניות וההקרנה כבר יופעלו.
onRemove
onRemove()
פרמטרים: אין
ערך מוחזר: void
מטמיעים את השיטה הזו כדי להסיר את הרכיבים מה-DOM. השיטה הזו נקראת פעם אחת אחרי קריאה ל-setMap(null).
setMap
setMap(map)
פרמטרים:
הערך המוחזר: אין
הוספת שכבת-העל למפה או לתמונה הפנורמית.
‫עברו בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

ממשק MapPanes

ממשק google.maps.MapPanes

floatPane
סוג: Element
החלונית הזו מכילה את חלון המידע. הוא נמצא מעל כל שכבות העל של המפה. (חלונית 4).
mapPane
סוג: Element
החלונית הזו היא החלונית הנמוכה ביותר, והיא נמצאת מעל המשבצות. הוא לא מקבל אירועי DOM. (חלונית 0).
markerLayer
סוג: Element
החלונית הזו מכילה סמנים. הוא לא מקבל אירועי DOM. (חלונית 2).
overlayLayer
סוג: Element
החלונית הזו מכילה קווים פוליגוניים, פוליגונים, שכבות-על של שכבות אריחים ושכבות-על של שכבות קרקע. הוא לא מקבל אירועי DOM. (חלונית 1).
overlayMouseTarget
סוג: Element
החלונית הזו מכילה רכיבים שמקבלים אירועי DOM. (חלונית 3).

ממשק MapCanvasProjection

ממשק google.maps.MapCanvasProjection

האובייקט הזה זמין ל-OverlayView מתוך השיטה draw. לא מובטח שהיא תופעל עד שתתבצע קריאה ל-draw.
fromContainerPixelToLatLng
fromContainerPixelToLatLng(pixel[, noClampNoWrap])
פרמטרים:
  • pixel: Point optional
  • noClampNoWrap: boolean optional
ערך מוחזר: LatLng|null
מחשב את הקואורדינטות הגיאוגרפיות מקואורדינטות הפיקסלים בקונטיינר של המפה.
fromDivPixelToLatLng
fromDivPixelToLatLng(pixel[, noClampNoWrap])
פרמטרים:
  • pixel: Point optional
  • noClampNoWrap: boolean optional
ערך מוחזר: LatLng|null
מחשבת את הקואורדינטות הגיאוגרפיות מקואורדינטות הפיקסלים ב-div שמכיל את המפה שניתן לגרור.
fromLatLngToContainerPixel
fromLatLngToContainerPixel(latLng)
פרמטרים:
ערך מוחזר: Point|null
מחשב את קואורדינטות הפיקסלים של המיקום הגיאוגרפי הנתון ברכיב המאגר של המפה.
fromLatLngToDivPixel
fromLatLngToDivPixel(latLng)
פרמטרים:
ערך מוחזר: Point|null
מחשבת את קואורדינטות הפיקסלים של המיקום הגיאוגרפי הנתון ברכיב ה-DOM שמכיל את המפה שניתן לגרור.
getVisibleRegion
getVisibleRegion()
פרמטרים: אין
ערך מוחזר: VisibleRegion|null
האזור הגלוי במפה. הפונקציה מחזירה את הערך null אם למפה אין גודל. הפונקציה מחזירה את הערך null אם ה-OverlayView נמצא ב-StreetViewPanorama.
getWorldWidth
getWorldWidth()
פרמטרים: אין
ערך מוחזר: number
רוחב העולם בפיקסלים ברמת הזום הנוכחית. בהיטלים עם זווית כיוון של 90 או 270 מעלות, הערך הזה תואם לטווח הפיקסלים בציר ה-Y.