DOM elements

מחלקת LayerView

מחלקה google.maps.OverlayView

ניתן להטמיע את הסיווג הזה כדי להציג סוגים מותאמים אישית של אובייקטים על המפה.

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

יש ליישם שלוש שיטות: onAdd(), draw() ו-onRemove().

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

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

השיעור הזה נמשך MVCObject.

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

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

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

שיטות
draw	draw() פרמטרים: ללא ערך החזרה: ללא מטמיעים את השיטה הזו כדי לשרטט או לעדכן את שכבת-העל. משתמשים במיקום מ-projection.fromLatLngToDivPixel() כדי למקם את שכבת-העל בצורה נכונה ביחס ל-MAPPanes. שיטה זו נקראת אחרי onAdd(), והיא נקראת בעת שינוי מרחק מהתצוגה או האמצע. לא מומלץ לעבוד בשיטה הזו בעלות חישובית.
getMap	getMap() פרמטרים: ללא ערך החזרה:  Map|StreetViewPanorama
getPanes	getPanes() פרמטרים: ללא ערך החזרה:  MapPanes|null מחזיר את החלוניות שבהן ניתן להציג את שכבת-העל. החלוניות לא אותחלו עד לקריאת ה-API על ידי onAdd.
getProjection	getProjection() פרמטרים: ללא ערך החזרה:  MapCanvasProjection מחזירה את האובייקט MapCanvasProjection המשויך ל-OverlayView הזה. ההיטל לא מאותחל עד שה-API נקרא ל-onAdd.
onAdd	onAdd() פרמטרים: ללא ערך החזרה: ללא מטמיעים את השיטה הזו כדי להפעיל את רכיבי ה-DOM של שכבת-העל. ניתן לקרוא לשיטה הזו פעם אחת לאחר הקריאה ל-setMaps() עם מפה חוקית. בשלב הזה, החלוניות וההקרנה יופעלו.
onRemove	onRemove() פרמטרים: ללא ערך החזרה: ללא מטמיעים את השיטה הזו כדי להסיר את הרכיבים מה-DOM. שיטה זו נקראת פעם אחת לאחר קריאה ל-setMaps(null).
setMap	setMap(map) פרמטרים:  map:  Map|StreetViewPanorama optional המפה או התמונה הפנורמית. אם הערך null, השכבה תוסר. ערך החזרה: ללא מוסיף את שכבת-העל למפה או לפנורמות.
עברו בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

הממשק של MapsPanes

ממשק google.maps.MapPanes

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

ממשק MapsCanvasProjection

ממשק google.maps.MapCanvasProjection

האובייקט הזה הופך לזמין ל-OverlayView מתוך שיטת השרטוט. לא בטוח שהפעולה הזו תופעל עד שהקריאה לשרטוט תתבצע.

שיטות
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 אם ה-שכבת-על נמצאת ב-StreetViewPanorama.
getWorldWidth	getWorldWidth() פרמטרים: ללא ערך החזרה:  number רוחב העולם בפיקסלים ברמת המרחק מהתצוגה הנוכחית. בתחזיות עם זווית כותרת של 90 או 270 מעלות, ההגדרה הזו תואמת לטווח הפיקסלים בציר ה-Y.