هشدار امنیتی : ما از یک مشکل امنیتی آگاه شده‌ایم که ممکن است وب‌سایت‌هایی را که از کتابخانه‌های شخص ثالث خاصی استفاده می‌کنند (از جمله polyfill.io) تحت تأثیر قرار دهد. این مشکل گاهی اوقات می‌تواند بازدیدکنندگان را بدون اطلاع یا اجازه صاحب وب‌سایت از وب‌سایت مورد نظر دور کند. بسیاری از نمونه‌های جاوا اسکریپت ما قبلاً شامل اعلان اسکریپت polyfill.io بودند. ما این را از نمونه های خود حذف کرده ایم. اگر از نمونه های جاوا اسکریپت ما که حاوی این اعلان هستند استفاده کرده اید، توصیه می کنیم اعلان را حذف کنید.

اطلاعیه : سبک نقشه پایه جدید به زودی به پلتفرم نقشه های گوگل می آید. این به‌روزرسانی برای استایل نقشه شامل یک پالت رنگی پیش‌فرض جدید، پین‌های مدرن شده و بهبودهایی در تجربه‌ها و قابلیت استفاده از نقشه است. همه سبک‌های نقشه به‌طور خودکار در مارس 2025 به‌روزرسانی می‌شوند. برای اطلاعات بیشتر در مورد در دسترس بودن و نحوه انتخاب زودتر، به سبک نقشه جدید برای پلتفرم Google Maps مراجعه کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Event system

کلاس رویداد

google.maps . event کلاس 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` تابع شنونده داده شده را به نام رویداد داده شده برای نمونه شی داده شده اضافه می کند. یک شناسه برای این شنونده برمی‌گرداند که می‌تواند با removeListener() استفاده شود.
`addListenerOnce`	`addListenerOnce(instance, eventName, handler)` مولفه های: `instance` : `Object` `eventName` : `string` `handler` : `Function` مقدار بازگشتی: `MapsEventListener` مانند addListener، اما کنترل کننده پس از مدیریت اولین رویداد، خود را حذف می کند.
`clearInstanceListeners`	`clearInstanceListeners(instance)` مولفه های: `instance` : `Object` مقدار برگشتی: `void` همه شنوندگان را برای همه رویدادها برای نمونه داده شده حذف می کند.
`clearListeners`	`clearListeners(instance, eventName)` مولفه های: `instance` : `Object` `eventName` : `string` مقدار برگشتی: `void` تمام شنوندگان رویداد داده شده را برای نمونه داده شده حذف می کند.
`hasListeners`	`hasListeners(instance, eventName)` مولفه های: `instance` : `Object` `eventName` : `string` مقدار بازگشتی: `boolean` در صورت وجود شنوندگان برای رویداد داده شده در نمونه داده شده، برمی گردد. می توان از آن برای صرفه جویی در محاسبه جزئیات رویداد گران قیمت استفاده کرد.
`removeListener`	`removeListener(listener)` مولفه های: `listener` : `MapsEventListener` مقدار برگشتی: `void` شنونده داده شده را حذف می کند، که باید توسط 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` ثبت نام کنترل کننده رویداد متقابل مرورگر. این شنونده با فراخوانی 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 . MapsEventListener

شنونده رویداد، ایجاد شده توسط google.maps.event.addListener () و دوستان.

مواد و روش ها
`remove`	`remove()` پارامترها: ندارد مقدار برگشتی: `void` شنونده را حذف می کند. فراخوانی `listener.remove()` معادل `google.maps.event.removeListener(listener)` است.

کلاس MVCObject

google.maps . MVCObject کلاس google.maps . MVCObject

کلاس پایه پیاده سازی KVO.

سازنده 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` تابع شنونده داده شده را به نام رویداد داده شده اضافه می کند. یک شناسه برای این شنونده برمی‌گرداند که می‌تواند با `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` ارزش بازگشتی: ندارد یک اتصال را حذف می کند. Unbinding ویژگی unbound را به مقدار فعلی تنظیم می کند. چون مقدار تغییر نکرده است به شی اطلاع داده نمی شود.
`unbindAll`	`unbindAll()` پارامترها: ندارد ارزش بازگشتی: ندارد تمام اتصالات را حذف می کند.

کلاس MVCAray

google.maps . MVCArray<T> کلاس 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 (عنصر، شاخص) فراخوانی می شود.
`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)` استدلال ها: `number` `index` این رویداد زمانی که `insertAt()` فراخوانی می شود فعال می شود. رویداد ایندکسی را که به `insertAt()` ارسال شده است، ارسال می کند.
`remove_at`	`function(index, removed)` استدلال ها: `number` `index` `removed` : `T` عنصر حذف شده از آرایه در `index` . این رویداد زمانی فعال می شود که `removeAt()` فراخوانی شود. رویداد، شاخصی را که به `removeAt()` و عنصری که از آرایه حذف شده است، ارسال می کند.
`set_at`	`function(index, previous)` استدلال ها: `number` `index` `previous` : `T` عنصری که قبلاً در آرایه در `index` قرار داشت. این رویداد زمانی فعال می شود که `setAt()` فراخوانی شود. رویداد، شاخصی را که به `setAt()` و عنصری که قبلاً در آرایه آن ایندکس بود، ارسال می‌کند.

رابط ErrorEvent

google.maps . ErrorEvent رابط google.maps . ErrorEvent

رویدادی با خطای مرتبط.

خواص
`error`	نوع: `Error` خطای مربوط به رویداد

Event system

کلاس رویداد

روش های استاتیک

رابط MapsEventListener

مواد و روش ها

کلاس MVCObject

سازنده

مواد و روش ها

کلاس MVCAray

سازنده

مواد و روش ها

مناسبت ها

رابط ErrorEvent

خواص