Image overlays

הממשק MapType

ממשק google.maps.MapType

הממשק הזה מגדיר את סוג המפה, והוא משמש בדרך כלל לסוגי מפות מותאמים אישית. לא ניתן לשינוי.

maxZoom
סוג:  number
רמת הזום המקסימלית של המפה כשמוצגת MapType הזו. חובה ל-MapTypes בסיסיים, מתעלמים ממנו ב-MapTypes שכבת-על.
minZoom
סוג:  number
רמת הזום המינימלית של המפה כשמוצגת MapType הזו. אופציונלי. ערך ברירת המחדל הוא 0.
radius
סוג:  number
רדיוס הכוכב במפה, במטרים. אופציונלי. ברירת המחדל היא רדיוס קו המשווה של כדור הארץ, 6378137 מטרים.
tileSize
סוג:  Size
המאפיינים של כל משבצת. חובה.
alt optional
סוג:  string optional
טקסט חלופי שיוצג כשעוברים עם העכבר מעל הלחצן של סוג המפה הזה ב-MapTypeControl. זה שינוי אופציונלי.
name optional
סוג:  string optional
השם שיוצג ב-MapTypeControl. זה שינוי אופציונלי.
projection optional
סוג:  Projection optional
התצוגה (projection) ששימשה לעיבוד הגרפי של סוג המפה הזה. אופציונלי. ברירת המחדל היא Mercator.
getTile
getTile(tileCoord, zoom, ownerDocument)
פרמטרים: 
  • tileCoordPoint קואורדינטות של משבצת.
  • zoomnumber הגדלת התצוגה של המשבצות.
  • ownerDocumentDocument המסמך שבבעלותו המשבצת הזו.
ערך המוחזר:  Element|null המשבצת שמתקבלת.
הפונקציה מחזירה משבצת לפי קואורדינטת המשבצת (x, y) ורמת הזום שצוינו. המשבצת הזו תצורף ל-ownerDocument שצוין. האפשרות הזו לא זמינה לסוגים של מפות בסיס.
releaseTile
releaseTile(tile)
פרמטרים: 
  • tileElement optional האריח שרוצים לשחרר.
ערך המוחזר:  None
הפונקציה משחררת את האריחים שצוינו, ומבצעת את פעולות הניקוי הנדרשות. המשבצת שסיפקתם כבר תוסר מהמסמך. זה שינוי אופציונלי.

ממשק Projection

ממשק google.maps.Projection

fromLatLngToPoint
fromLatLngToPoint(latLng[, point])
פרמטרים: 
ערך המוחזר:  Point|null
תרגום מהצינור של LatLng למישור של Point. בממשק הזה מצוין פונקציה שמטמיעה תרגום מערכי LatLng נתונים לקואורדינטות גלובאליות בתצוגת המפה. ה-Maps API קורא לשיטה הזו כשצריך להציג מיקומים במסך. אובייקטים מסוג Projection חייבים להטמיע את השיטה הזו, אבל הם יכולים להחזיר את הערך null אם לא ניתן לחשב את הערך של Point בזמן ההצגה.
fromPointToLatLng
fromPointToLatLng(pixel[, noClampNoWrap])
פרמטרים: 
  • pixelPoint
  • noClampNoWrapboolean optional
ערך המוחזר:  LatLng|null
הממשק הזה מציין פונקציה שמטמיעה תרגום מצירים גלובליים על הקרנת מפה לערכים של LatLng. ה-Maps API קורא לשיטה הזו כשצריך לתרגם פעולות במסך למיקומים במפה. אובייקטים מסוג Projection חייבים להטמיע את השיטה הזו, אבל הם יכולים להחזיר את הערך null אם לא ניתן לחשב את הערך של LatLng בזמן ההצגה.

הכיתה ImageMapType

google.maps.ImageMapType class

המחלקה הזו מיישמת את הממשק MapType ומשמשת לעיבוד (רנדר) של משבצות תמונה.

הכיתה הזו היא תת-מחלקה של MVCObject.

המחלקה הזו מטמיעה את MapType.

אפשר לגשת אליו באמצעות חיוג למספר const {ImageMapType} = await google.maps.importLibrary("maps"). ספריות ב-Maps JavaScript API

ImageMapType
ImageMapType(opts)
פרמטרים: 
יצירת ImageMapType באמצעות ImageMapTypeOptions שסופק
alt
סוג:  string optional
maxZoom
סוג:  number
minZoom
סוג:  number
name
סוג:  string optional
projection
סוג:  Projection
radius
סוג:  number
tileSize
סוג:  Size
getOpacity
getOpacity()
פרמטרים:  ללא
ערך המובהק:  number opacity השקיפות הנוכחית.
הפונקציה מחזירה את רמת השקיפות (0 (שקוף) עד 1.0) של המשבצות ImageMapType.
getTile
getTile(tileCoord, zoom, ownerDocument)
פרמטרים: 
  • tileCoordPoint קואורדינטות של משבצת.
  • zoomnumber הגדלת התצוגה של המשבצות.
  • ownerDocumentDocument המסמך שבבעלותו המשבצת הזו.
ערך המוחזר:  Element|null המשבצת שמתקבלת.
releaseTile
releaseTile(tileDiv)
פרמטרים: 
  • tileDivElement optional האריח שרוצים לשחרר.
ערך המוחזר:  None
setOpacity
setOpacity(opacity)
פרמטרים: 
  • opacitynumber השקיפות החדשה.
ערך המוחזר:  None
הגדרת רמת האטימות (0 (שקוף) עד 1.0) של המשבצות ImageMapType.
עובר בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
tilesloaded
function()
ארגומנטים:  None
האירוע הזה מופעל כשהמטרות הנראות מסתיימות לטעינת.

ממשק ImageMapTypeOptions

ממשק google.maps.ImageMapTypeOptions

הכיתה הזו משמשת ליצירת MapType שמרינדר משבצות תמונה.

alt optional
סוג:  string optional
טקסט חלופי שיוצג כשעוברים עם העכבר מעל הלחצן של סוג המפה הזה ב-MapTypeControl.
getTileUrl optional
סוג:  function(Point, number): (string optional) optional
הפונקציה מחזירה מחרוזת (כתובת URL) עבור קואורדינטות משבצת (x, y) נתונות ורמת זום נתונה.
maxZoom optional
סוג:  number optional
רמת הזום המקסימלית של המפה כשמוצגת MapType הזו.
minZoom optional
סוג:  number optional
רמת הזום המינימלית של המפה כשמוצגת MapType הזו. זה שינוי אופציונלי.
name optional
סוג:  string optional
השם שיוצג ב-MapTypeControl.
opacity optional
סוג:  number optional
רמת האטימות שתחול על כרטיסי המידע. יש לציין את השקיפות כערך של float בין 0 ל-1.0, כאשר 0 הוא שקוף לחלוטין ו-1 הוא אטום לחלוטין.
tileSize optional
סוג:  Size optional
הגודל של קטעי המפה.

הכיתה GroundOverlay

google.maps.GroundOverlay class

שכבת-על של תמונה מלבנית במפה.

הכיתה הזו היא תת-מחלקה של MVCObject.

אפשר לגשת אליו באמצעות חיוג למספר const {GroundOverlay} = await google.maps.importLibrary("maps"). ספריות ב-Maps JavaScript API

GroundOverlay
GroundOverlay(url, bounds[, opts])
פרמטרים: 
יצירת שכבת-על של שטח מכתובת ה-URL של התמונה שצוינה ומ-LatLngBounds שלה. התמונה מותאמת לגבולות הנוכחיים ומוקרנת באמצעות הקרנה של המפה הנוכחית.
getBounds
getBounds()
פרמטרים:  ללא
ערך המוחזר:  LatLngBounds
הפונקציה מקבלת את LatLngBounds של שכבת-העל הזו.
getMap
getMap()
פרמטרים:  ללא
ערך המוחזר:  Map
הפונקציה מחזירה את המפה שבה מוצג שכבת-העל הזו של הקרקע.
getOpacity
getOpacity()
פרמטרים:  ללא
ערך המוחזר:  number
הפונקציה מחזירה את מידת השקיפות של שכבת הרקע הזו.
getUrl
getUrl()
פרמטרים:  ללא
ערך המוחזר:  string
הפונקציה מקבלת את כתובת ה-URL של התמונה שמוצגת בפרויקטור.
setMap
setMap(map)
פרמטרים: 
ערך המוחזר:  None
המערכת מרינדרת את שכבת-העל של פני השטח במפה שצוינה. אם המפה מוגדרת לערך null, שכבת-העל תוסר.
setOpacity
setOpacity(opacity)
פרמטרים: 
  • opacitynumber
ערך המוחזר:  None
הגדרת השקיפות של שכבת-העל הזו של הקרקע.
עובר בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
click
function(event)
ארגומנטים: 
האירוע הזה מופעל כשאירוע הקליק ב-DOM מופעל ב-GroundOverlay.
dblclick
function(event)
ארגומנטים: 
האירוע הזה מופעל כשאירוע ה-dblclick של DOM מופעל ב-GroundOverlay.

הממשק GroundOverlayOptions

ממשק google.maps.GroundOverlayOptions

האובייקט הזה מגדיר את המאפיינים שאפשר להגדיר באובייקט GroundOverlay.

clickable optional
סוג:  boolean optional
אם הערך הוא true, שכבת-העל של הקרקע יכולה לקבל אירועי עכבר.
map optional
סוג:  Map optional
המפה שבה רוצים להציג את שכבת-העל.
opacity optional
סוג:  number optional
ברירת מחדל: 1.0
השקיפות של שכבת-העל, שמבוטאת כמספר בין 0 ל-1. זה שינוי אופציונלי.

הכיתה StyledMapType

google.maps.StyledMapType class

יצירת MapType עם סגנון בהתאמה אישית.

הכיתה הזו היא תת-מחלקה של MVCObject.

המחלקה הזו מטמיעה את MapType.

אפשר לגשת אליו באמצעות חיוג למספר const {StyledMapType} = await google.maps.importLibrary("maps"). ספריות ב-Maps JavaScript API

StyledMapType
StyledMapType(styles[, options])
פרמטרים: 
יצירת MapType עם סגנון לפי האפשרויות שצוינו. הפונקציה StyledMapType מקבלת מערך של פונקציות MapTypeStyle, כאשר כל פונקציית MapTypeStyle חלה על המפה בזה אחר זה. MapTypeStyle מאוחר יותר שמחילה את אותם MapTypeStyler על אותם סלקטורים כמו MapTypeStyle מוקדם יותר, תבטל את MapTypeStyle המוקדם יותר.
alt
סוג:  string
maxZoom
סוג:  number
minZoom
סוג:  number
name
סוג:  string
projection
סוג:  Projection
radius
סוג:  number
tileSize
סוג:  Size
getTile
getTile(tileCoord, zoom, ownerDocument)
פרמטרים: 
  • tileCoordPoint קואורדינטות של משבצת.
  • zoomnumber הגדלת התצוגה של המשבצות.
  • ownerDocumentDocument המסמך שבבעלותו המשבצת הזו.
ערך המוחזר:  Element|null המשבצת שמתקבלת.
releaseTile
releaseTile(tile)
פרמטרים: 
  • tileElement optional האריח שרוצים לשחרר.
ערך המוחזר:  None
עובר בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

הממשק StyledMapTypeOptions

ממשק google.maps.StyledMapTypeOptions

הכיתה הזו משמשת לציון אפשרויות בזמן יצירת StyledMapType. אי אפשר לשנות את האפשרויות האלה אחרי שיוצרים את StyledMapType.

alt optional
סוג:  string optional
הטקסט שיוצג כשמעבירים את העכבר מעל הלחצן MapType בבורר סוג המפה.
maxZoom optional
סוג:  number optional
רמת הזום המקסימלית של המפה כשהיא מציגה את MapType הזה. זה שינוי אופציונלי.
minZoom optional
סוג:  number optional
רמת הזום המינימלית של המפה כשהיא מציגה את MapType הזה. זה שינוי אופציונלי.
name optional
סוג:  string optional
השם שיוצג בפקדי סוג המפה.