DOM elements

המחלקה OverlayView

google.maps.OverlayView class
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) פרמטרים: element: Element הערך המוחזר: אין מונע מאירועי קליק, לחיצה, גרירה וגלגלת ברכיב לעבור למפה. אפשר להשתמש באפשרות הזו כדי למנוע גרירה של המפה ושינוי מרחק התצוגה, וגם אירועי "קליק" במפה.
preventMapHitsFrom	preventMapHitsFrom(element) פרמטרים: element: Element הערך המוחזר: אין מונעת מהקליק או מהלחיצה על הרכיב לעבור למפה. אפשר להשתמש בזה כדי למנוע מהמפה להפעיל אירועי "קליק".

Methods
draw	draw() פרמטרים: אין ערך מוחזר: void מטמיעים את השיטה הזו כדי לצייר או לעדכן את שכבת-העל. משתמשים במיקום מ-projection.fromLatLngToDivPixel() כדי למקם נכון את שכבת-העל ביחס ל-MapPanes. השיטה הזו נקראת אחרי onAdd(), ונקראת כשמשנים את מרכז המפה או את רמת הזום. לא מומלץ לבצע עבודה שדורשת משאבי מחשוב רבים בשיטה הזו.
getMap	getMap() פרמטרים: אין ערך מוחזר: Map|StreetViewPanorama
getPanes	getPanes() פרמטרים: אין ערך מוחזר: MapPanes|null מחזירה את החלוניות שבהן אפשר לעבד את OverlayView. החלוניות לא מאותחלות עד שה-API קורא ל-onAdd.
getProjection	getProjection() פרמטרים: אין ערך מוחזר: MapCanvasProjection מחזירה את האובייקט MapCanvasProjection שמשויך ל-OverlayView הזה. ההיטל לא מאותחל עד שה-API קורא ל-onAdd.
onAdd	onAdd() פרמטרים: אין ערך מוחזר: void צריך להטמיע את השיטה הזו כדי להפעיל את רכיבי ה-DOM של שכבת-העל. השיטה הזו נקראת פעם אחת אחרי ש-setMap()‎ נקראת עם מפה תקינה. בשלב הזה, החלוניות וההקרנה כבר יופעלו.
onRemove	onRemove() פרמטרים: אין ערך מוחזר: void מטמיעים את השיטה הזו כדי להסיר את הרכיבים מה-DOM. השיטה הזו נקראת פעם אחת אחרי קריאה ל-setMap(null).
setMap	setMap(map) פרמטרים: ‫map: Map|StreetViewPanorama optional המפה או הפנורמה. אם null, השכבה תוסר. הערך המוחזר: אין הוספת שכבת-העל למפה או לתמונה הפנורמית.
‫עברו בירושה: 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.

Methods
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) פרמטרים: latLng: LatLng|LatLngLiteral ערך מוחזר: Point|null מחשב את קואורדינטות הפיקסלים של המיקום הגיאוגרפי הנתון ברכיב המאגר של המפה.
fromLatLngToDivPixel	fromLatLngToDivPixel(latLng) פרמטרים: latLng: LatLng|LatLngLiteral optional ערך מוחזר: Point|null מחשבת את קואורדינטות הפיקסלים של המיקום הגיאוגרפי הנתון ברכיב ה-DOM שמכיל את המפה שניתן לגרור.
getVisibleRegion	getVisibleRegion() פרמטרים: אין ערך מוחזר: VisibleRegion|null האזור הגלוי במפה. הפונקציה מחזירה את הערך null אם למפה אין גודל. הפונקציה מחזירה את הערך null אם ה-OverlayView נמצא ב-StreetViewPanorama.
getWorldWidth	getWorldWidth() פרמטרים: אין ערך מוחזר: number רוחב העולם בפיקסלים ברמת הזום הנוכחית. בהיטלים עם זווית כיוון של 90 או 270 מעלות, הערך הזה תואם לטווח הפיקסלים בציר ה-Y.