הודעה: בקרוב תהיה אפשרות להשתמש בסגנון חדש למפות הבסיס בפלטפורמה של מפות Google. העדכון הזה לסגנון המפה כולל ערכת צבעים חדשה שמוגדרת כברירת מחדל, סיכות מודרניות ושיפורים בחוויית השימוש במפה ובממשק שלה. כל סגנונות המפה יעודכנו באופן אוטומטי במרץ 2025. מידע נוסף על הזמינות ועל האופן שבו אפשר להצטרף מוקדם יותר זמין במאמר סגנון מפה חדש בפלטפורמה של מפות Google.

דף זה תורגם על ידי Cloud Translation API.

Event system

event class

google.maps.event סיווג

מרחב שמות לכל הפונקציות של אירועים ציבוריים

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

שיטות סטטיות
`addListener`	`addListener(instance, eventName, handler)` פרמטרים: `instance`: `Object` `eventName`: `string` `handler`: `Function` הערך המוחזר: `MapsEventListener` הוספת פונקציית ה-listener הזאת לשם האירוע הנתון של מופע האובייקט הנתון. מחזירה מזהה עבור ה-listener הזה שאפשר להשתמש בו עם removeListener().
`addListenerOnce`	`addListenerOnce(instance, eventName, handler)` פרמטרים: `instance`: `Object` `eventName`: `string` `handler`: `Function` הערך המוחזר: `MapsEventListener` בדומה ל-addListener, אבל ה-handler מסיר את עצמו אחרי הטיפול באירוע הראשון.
`clearInstanceListeners`	`clearInstanceListeners(instance)` פרמטרים: `instance`: `Object` הערך המוחזר: `void` מסיר את כל המאזינים לכל האירועים של המכונה הנתונה.
`clearListeners`	`clearListeners(instance, eventName)` פרמטרים: `instance`: `Object` `eventName`: `string` הערך המוחזר: `void` מסיר את כל המאזינים של האירוע הנתון עבור המופע הנתון.
`hasListeners`	`hasListeners(instance, eventName)` פרמטרים: `instance`: `Object` `eventName`: `string` הערך המוחזר: `boolean` הפונקציה מחזירה את הפונקציה הזו אם יש פונקציות event listener לאירוע הנתון במכונה הנתונה. יכול לשמש לשמירת החישוב של פרטי אירועים יקרים.
`removeListener`	`removeListener(listener)` פרמטרים: `listener`: `MapsEventListener` הערך המוחזר: `void` מסיר את ה-listener הנתון, שהיה צריך להחזיר על ידי addListener למעלה. זהה להפעלה של `listener.remove()`.
`trigger`	`trigger(instance, eventName, eventArgs)` פרמטרים: `instance`: `Object` `eventName`: `string` `eventArgs`: `...?` הערך המוחזר: `void` מפעיל את האירוע הנתון. כל הארגומנטים אחרי eventName מועברים כארגומנטים למאזינים.
`addDomListener`	הוצא משימוש: `google.maps.event.addDomListener()` הוצא משימוש. במקומו צריך להשתמש בשיטה הרגילה addEventListener(). התכונה תמשיך לפעול ואנחנו לא מתכננים להוציא אותה משימוש. `addDomListener(instance, eventName, handler[, capture])` פרמטרים: `instance`: `Object` `eventName`: `string` `handler`: `Function` `capture`: `boolean optional` הערך המוחזר: `MapsEventListener` רישום של גורם handler לאירועים בדפדפנים שונים. כדי להסיר את ה-listener הזה, צריך לקרוא ל-removeListener(handle) בכינוי שמוחזר על ידי הפונקציה הזו.
`addDomListenerOnce`	הוצא משימוש: `google.maps.event.addDomListenerOnce()` הוצא משימוש. במקומו צריך להשתמש בשיטה הרגילה addEventListener(). התכונה תמשיך לפעול ואנחנו לא מתכננים להוציא אותה משימוש. `addDomListenerOnce(instance, eventName, handler[, capture])` פרמטרים: `instance`: `Object` `eventName`: `string` `handler`: `Function` `capture`: `boolean optional` הערך המוחזר: `MapsEventListener` מעטפת מסביב ל-addDomListener שמסיר את המאזינים אחרי האירוע הראשון.

ממשק MapsEventListener

ממשק google.maps.MapsEventListener

האזנה לאירוע, שנוצרה על ידי google.maps.event.addListener() וחברים.

שיטות
`remove`	`remove()` פרמטרים: ללא הערך המוחזר: `void` הסרה של ה-listener. קריאה ל-`listener.remove()` מקבילה ל`google.maps.event.removeListener(listener)`.

המחלקה MVCObject

google.maps.MVCObject סיווג

מחלקת בסיס שמטמיעה KVO.

מובטח שה-constructor של MVCObject יהיה פונקציה ריקה, כך שתוכלו לקבל בירושה מ-MVCObject על ידי כתיבת MySubclass.prototype = new google.maps.MVCObject();. אלא אם צוין אחרת, הכלל הזה לא רלוונטי למחלקות אחרות ב-API, ואין תמיכה בירושה ממחלקות אחרות ב-API.

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

יצרן
`MVCObject`	`MVCObject()` פרמטרים: ללא ייווצר `MVCObject`.

שיטות
`addListener`	`addListener(eventName, handler)` פרמטרים: `eventName`: `string` `handler`: `Function` הערך המוחזר: `MapsEventListener` הפונקציה מוסיפה את פונקציית ה-listener שצוינה לשם האירוע הנתון. מחזירה מזהה עבור ה-listener הזה שאפשר להשתמש בו עם `google.maps.event.removeListener`.
`bindTo`	`bindTo(key, target[, targetKey, noNotify])` פרמטרים: `key`: `string` `target`: `MVCObject` `targetKey`: `string optional` `noNotify`: `boolean optional` ערך החזרה: ללא מקשרת תצוגה למודל.
`get`	`get(key)` פרמטרים: `key`: `string` הערך המוחזר: `?` הפונקציה מקבלת ערך.
`notify`	`notify(key)` פרמטרים: `key`: `string` ערך החזרה: ללא מודיעים לכל מי שמצביע על שינוי בנכס הזה. כך מתקבלת התראה גם על אובייקטים שקשורים למאפיין של האובייקט וגם על האובייקט שאליו הוא קשור.
`set`	`set(key, value)` פרמטרים: `key`: `string` `value`: `` ערך החזרה:* ללא מגדירה ערך.
`setValues`	`setValues([values])` פרמטרים: `values`: `Object optional` ערך החזרה: ללא מגדירה אוסף של צמדי מפתח/ערך.
`unbind`	`unbind(key)` פרמטרים: `key`: `string` ערך החזרה: ללא הסרת הקישור. ביטול הקישור מגדיר את המאפיין שאינו מאוגד לערך הנוכחי. האובייקט לא יקבל הודעה כי הערך לא השתנה.
`unbindAll`	`unbindAll()` פרמטרים: ללא ערך החזרה: ללא כל הקישורים יוסרו.

סיווג MVCArray

google.maps.MVCArray<T> סיווג

הכיתה הזו משתרעת על פני MVCObject.

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

יצרן
`MVCArray`	`MVCArray([array])` פרמטרים: `array`: `Array<T> optional` מערך MVC שניתן לשינוי.

שיטות
`clear`	`clear()` פרמטרים: ללא ערך החזרה: ללא מסירה את כל הרכיבים מהמערך.
`forEach`	`forEach(callback)` פרמטרים: `callback`: `function(T, number): void` ערך החזרה: ללא חוזרים על כל רכיב וקוראים להפעלה החוזרת שסופקה. מתבצעת קריאה חוזרת (callback) לכל רכיב, כגון: callback(רכיב, אינדקס).
`getArray`	`getArray()` פרמטרים: ללא הערך המוחזר: `Array<T>` מחזירה הפניה למערך הבסיסי. אזהרה: אם המערך עובר שינוי, שום אירוע לא יופעל על ידי האובייקט הזה.
`getAt`	`getAt(i)` פרמטרים: `i`: `number` הערך המוחזר: `T` מחזירה את הרכיב באינדקס שצוין.
`getLength`	`getLength()` פרמטרים: ללא הערך המוחזר: `number` מחזירה את מספר הרכיבים במערך הזה.
`insertAt`	`insertAt(i, elem)` פרמטרים: `i`: `number` `elem`: `T` ערך החזרה: ללא הוספת רכיב באינדקס שצוין.
`pop`	`pop()` פרמטרים: ללא הערך המוחזר: `T` מסירה את הרכיב האחרון של המערך ומחזירה את הרכיב.
`push`	`push(elem)` פרמטרים: `elem`: `T` הערך המוחזר: `number` הוספת רכיב אחד לסוף המערך ומחזירה את האורך החדש של המערך.
`removeAt`	`removeAt(i)` פרמטרים: `i`: `number` הערך המוחזר: `T` הסרת רכיב מהאינדקס שצוין.
`setAt`	`setAt(i, elem)` פרמטרים: `i`: `number` `elem`: `T` ערך החזרה: ללא מגדיר רכיב באינדקס שצוין.
עברה בירושה: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

אירועים
`insert_at`	`function(index)` ארגומנטים: `index`: `number` האירוע הזה מופעל כאשר מתבצעת קריאה ל-`insertAt()`. האירוע מעביר את האינדקס שהועבר אל `insertAt()`.
`remove_at`	`function(index, removed)` ארגומנטים: `index`: `number` `removed`: `T` הרכיב הוסר מהמערך ב-`index`. האירוע הזה מופעל כאשר מתבצעת קריאה ל-`removeAt()`. האירוע מעביר את האינדקס שהועבר אל `removeAt()` ואת האלמנט שהוסר מהמערך.
`set_at`	`function(index, previous)` ארגומנטים: `index`: `number` `previous`: `T` הרכיב שהיה בעבר במערך ב-`index`. האירוע הזה מופעל כאשר מתבצעת קריאה ל-`setAt()`. האירוע מעביר את האינדקס שהועבר אל `setAt()` ואת הרכיב שהיה קיים קודם במערך באינדקס הזה.

ממשק ErrorEvent

ממשק google.maps.ErrorEvent

אירוע עם שגיאה משויכת.

תכונות
`error`	סוג: `Error` השגיאה שקשורה לאירוע.

Event system

event class

שיטות סטטיות

ממשק MapsEventListener

שיטות

המחלקה MVCObject

יצרן

שיטות

סיווג MVCArray

יצרן

שיטות

אירועים

ממשק ErrorEvent

תכונות