DOM elements

‫OverlayView class

google.maps.OverlayView class

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

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

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

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

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

הכיתה הזו היא הרחבה של MVCObject.

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

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

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

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

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.