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