Image overlays

ממשק MapType

ממשק google.maps.MapType
מיושם על ידי ImageMapType, StyledMapType

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

ממשק Projection

ממשק google.maps.Projection

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

המחלקה ImageMapType

class google.maps.ImageMapType extends MVCObject implements MapType
library "maps"

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

const {ImageMapType} = await google.maps.importLibrary("maps");
ImageMapType
ImageMapType(opts)
פרמטרים:
יוצר ImageMapType באמצעות ImageMapTypeOptions שסופקו
alt
סוג: string optional
maxZoom
סוג: number
minZoom
סוג: number
name
סוג: string optional
projection
סוג: Projection optional
radius
סוג: number
tileSize
סוג: Size optional
getOpacity
getOpacity()
פרמטרים: אין
ערך מוחזר: number אטימות האטימות הנוכחית.
הפונקציה מחזירה את רמת השקיפות (0 (שקוף) עד 1.0) של המשבצות של ImageMapType.
getTile
getTile(tileCoord, zoom, ownerDocument)
פרמטרים:
  • tileCoord: Point optional קואורדינטות של קטע במפה.
  • zoom: number זום על המשבצת.
  • ‫ownerDocument: Document optional המסמך שהמשבצת הזו שייכת לו.
ערך החזרה: Element|null המשבצת שנוצרה.
releaseTile
releaseTile(tileDiv)
פרמטרים:
  • tileDiv: Element optional משבצת לשחרור.
הערך המוחזר: אין
setOpacity
setOpacity(opacity)
פרמטרים:
  • ‫opacity: number האטימות החדשה.
הערך המוחזר: אין
ההגדרה הזו קובעת את רמת האטימות (0 (שקוף) עד 1.0) של המשבצות ב-ImageMapType.
‫עברו בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
tilesloaded
function()
ארגומנטים: אין
האירוע הזה מופעל כשהמשבצות הגלויות מסיימות להיטען.

ממשק ImageMapTypeOptions

ממשק google.maps.ImageMapTypeOptions

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

המחלקה GroundOverlay

class google.maps.GroundOverlay extends MVCObject
library "maps"

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

const {GroundOverlay} = await google.maps.importLibrary("maps");
GroundOverlay
GroundOverlay(url, bounds[, opts])
פרמטרים:
יוצר שכבת-על של פני השטח מכתובת ה-URL של התמונה שצוינה ומה-LatLngBounds שלה. גודל התמונה מותאם לגבולות הנוכחיים, והיא מוצגת באמצעות היטל המפה הנוכחי.
getBounds
getBounds()
פרמטרים: אין
ערך מוחזר: LatLngBounds|null
הפונקציה מחזירה את ה-LatLngBounds של שכבת-העל הזו.
getMap
getMap()
פרמטרים: אין
ערך מוחזר: Map|null
מחזירה את המפה שבה מוצגת שכבת-העל הזו של פני השטח.
getOpacity
getOpacity()
פרמטרים: אין
ערך מוחזר: number
מחזירה את השקיפות של שכבת-העל הזו על פני הקרקע.
getUrl
getUrl()
פרמטרים: אין
ערך מוחזר: string
מקבל את כתובת ה-URL של התמונה המוצגת.
setMap
setMap(map)
פרמטרים:
  • map: Map optional
ערך מוחזר: void
מציג את שכבת העל של הקרקע במפה שצוינה. אם המפה מוגדרת לערך null, שכבת-העל תוסר.
setOpacity
setOpacity(opacity)
פרמטרים:
  • opacity: number
ערך מוחזר: void
ההגדרה הזו קובעת את רמת האטימות של שכבת העל הזו של פני השטח.
‫עברו בירושה: 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
אופציונלי
סוג: boolean optional
אם הערך הוא true, שכבת העל של הקרקע יכולה לקבל אירועי עכבר.
map
אופציונלי
סוג: Map optional
המפה שבה תוצג השכבה.
opacity
אופציונלי
סוג: number optional
ברירת המחדל: 1.0
האטימות של שכבת-העל, מיוצגת כמספר בין 0 ל-1. אופציונלי.

המחלקה StyledMapType

class google.maps.StyledMapType extends MVCObject implements MapType
library "maps"

יצירת MapType בסגנון אישי.

const {StyledMapType} = await google.maps.importLibrary("maps");
StyledMapType
StyledMapType(styles[, options])
פרמטרים:
  • styles: Array<MapTypeStyle optional> optional הסגנונות שרוצים להחיל.
  • options: StyledMapTypeOptions optional האפשרויות של סוגי המפות המסוגננות.
יוצרת MapType מעוצב עם האפשרויות שצוינו. הפונקציה StyledMapType מקבלת מערך של אובייקטים מסוג MapTypeStyle, וכל אובייקט MapTypeStyle מוחל על המפה ברצף. MapTypeStyle מאוחר יותר שמחיל את אותם MapTypeStyler על אותם בוררים כמו MapTypeStyle מוקדם יותר, יבטל את ה-MapTypeStyle המוקדם יותר.

שימו לב: אין תמיכה ב-StyledMapType כשמוגדר מזהה מפה. אם תשתמשו בשניהם יחד, תופיע אזהרה במסוף.
alt
סוג: string
maxZoom
סוג: number
minZoom
סוג: number
name
סוג: string
projection
סוג: Projection optional
radius
סוג: number
tileSize
סוג: Size optional
getTile
getTile(tileCoord, zoom, ownerDocument)
פרמטרים:
  • tileCoord: Point optional קואורדינטות של קטע במפה.
  • zoom: number זום על המשבצת.
  • ‫ownerDocument: Document optional המסמך שהמשבצת הזו שייכת לו.
ערך החזרה: Element|null המשבצת שנוצרה.
releaseTile
releaseTile(tile)
פרמטרים:
  • tile: Element optional משבצת לשחרור.
ערך מוחזר: void
‫עברו בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

הממשק StyledMapTypeOptions

ממשק google.maps.StyledMapTypeOptions

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