מחלקת 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) פרמטרים:
ערך החזרה: ללא
עוצר את אירועי הקליק, הגרירה, הגרירה והגלגל על הרכיב כדי לפוצץ למעלה למפה. השתמשו בה כדי למנוע גרירה וזום של מפות, וכן אירועי "קליק" במפה. |
preventMapHitsFrom |
preventMapHitsFrom(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) פרמטרים:
ערך החזרה: ללא
מוסיף את שכבת-העל למפה או לפנורמות. |
עברו בירושה:
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]) פרמטרים:
ערך החזרה:
LatLng|null מחשב את הקואורדינטות הגיאוגרפיות מתוך קואורדינטות של פיקסלים במאגר התגים של המפה. |
fromDivPixelToLatLng |
fromDivPixelToLatLng(pixel[, noClampNoWrap]) פרמטרים:
ערך החזרה:
LatLng|null מחשב את הקואורדינטות הגיאוגרפיות מתוך קואורדינטות של פיקסלים ב-div המכיל את המפה שניתנת לגרירה. |
fromLatLngToContainerPixel |
fromLatLngToContainerPixel(latLng) פרמטרים:
ערך החזרה:
Point|null מחשב את הקואורדינטות של הפיקסל עבור המיקום הגיאוגרפי הנתון ברכיב הגורם המכיל של המפה. |
fromLatLngToDivPixel |
fromLatLngToDivPixel(latLng) פרמטרים:
ערך החזרה:
Point|null מחשב את הקואורדינטות של הפיקסל עבור המיקום הגיאוגרפי הנתון ברכיב ה-DOM שמכיל את המפה שניתנת לגרירה. |
getVisibleRegion |
getVisibleRegion() פרמטרים: ללא
ערך החזרה:
VisibleRegion|null האזור המוצג במפה. פונקציה זו מחזירה את הערך null אם למפה אין גודל. מחזירה null אם ה-שכבת-על נמצאת ב-StreetViewPanorama. |
getWorldWidth |
getWorldWidth() פרמטרים: ללא
ערך החזרה:
number רוחב העולם בפיקסלים ברמת המרחק מהתצוגה הנוכחית. בתחזיות עם זווית כותרת של 90 או 270 מעלות, ההגדרה הזו תואמת לטווח הפיקסלים בציר ה-Y. |