DOM elements

הכיתה OverlayView

google.maps.OverlayView class

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

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

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

• בשיטה onAdd(), צריך ליצור אובייקטים של DOM ולהוסיף אותם כצאצאים של החלונות.
• צריך למקם את הרכיבים האלה בשיטה draw().
• בשיטה onRemove(), צריך להסיר את האובייקטים מ-DOM.

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

הכיתה הזו היא תת-מחלקה של MVCObject.

כדי לגשת אליו, מתקשרים למספר const {OverlayView} = await google.maps.importLibrary("maps") או const {OverlayView} = await google.maps.importLibrary("streetView"). ספריות ב-Maps JavaScript API

יצרן
OverlayView	OverlayView() פרמטרים:  ללא יצירת OverlayView.

שיטות סטטיות
preventMapHitsAndGesturesFrom	preventMapHitsAndGesturesFrom(element) פרמטרים:  element:  Element ערך המוחזר:  None הפסקת האירועים של קליקים, הקשות, גרירה ושימוש בגלגל על האלמנט, כדי שהם לא יועברו למפה. אפשר להשתמש בה כדי למנוע גרירה של המפה ושינוי מרחק התצוגה, וגם אירועי 'קליק' במפה.
preventMapHitsFrom	preventMapHitsFrom(element) פרמטרים:  element:  Element ערך המוחזר:  None האפשרות הזו מונעת מלחיצה או מקשיבה על הרכיב להופיע במפה. אפשר להשתמש באפשרות הזו כדי למנוע מהמפה להפעיל אירועי 'קליק'.

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

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.