DOM elements

הסיווג OverlayView

google.maps.OverlayView סיווג

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

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

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

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

צריך לקרוא ל-setMap() אובייקט Map חוקי כדי להפעיל את הקריאה ל-method onAdd() ול-setMap(null) כדי להפעיל את השיטה onRemove(). אפשר להפעיל את השיטה 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 ערך החזרה: ללא מפסיק ללחוץ, להקיש, לגרור ולגלגל אירועים על הרכיב כך שלא יבעבע במפה. אפשר להשתמש באפשרות הזו כדי למנוע גרירה ושינוי של מרחק התצוגה במפה, כמו גם אירועי "לחיצה" במפה.
preventMapHitsFrom	preventMapHitsFrom(element) פרמטרים:  element:  Element ערך החזרה: ללא מפסיק ללחוץ או להקיש על הרכיב מבעבע כלפי מעלה במפה. אפשר להשתמש בכך כדי למנוע מהמפה להפעיל אירועי "קליק".

שיטות
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 מתוך שיטת השרטוט. לא בטוח שהפונקציה תופעל עד לקריאת השליפה.

שיטות
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.