إشعار: ستتوفّر قريبًا ميزة جديدة لتصميم الخرائط الأساسية في "منصة خرائط Google". يتضمّن هذا التعديل على تصميم الخريطة لوحة ألوان تلقائية جديدة وعلامات جديدة وتحسينات على تجارب الخريطة وسهولة استخدامها. سيتم تعديل جميع أنماط الخرائط تلقائيًا في آذار (مارس) 2025. لمزيد من المعلومات عن مدى التوفّر وكيفية التفعيل في وقت سابق، يُرجى الاطّلاع على نمط خريطة جديد لـ "منصة خرائط Google".

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Event system

الحدث

صف واحد (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.event.addListener()" والأصدقاء.

الطُرق
`remove`	`remove()` المَعلمات: لا شيء قيمة الإرجاع: `void` يزيل المستمع. الاتصال بـ `listener.remove()` يعادل `google.maps.event.removeListener(listener)`.

فئة MVCObject

صف واحد (google.maps.MVCObject)

فئة أساسية تستخدم خوارزمية KVO.

تضمن الدالة الإنشائية MVCObject أن تكون دالة فارغة، ولذلك يمكنك اكتسابها من MVCObject عن طريق كتابة MySubclass.prototype = new google.maps.MVCObject();. ولا ينطبق ذلك على الفئات الأخرى في واجهة برمجة التطبيقات، ما لم يُذكر خلاف ذلك، ولا يمكن اكتساب البيانات من الفئات الأخرى في واجهة برمجة التطبيقات.

يمكنك الوصول من خلال الاتصال على الرقم 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` قيمة الإرجاع: لا شيء لإزالة الربط. سيؤدي إلغاء الربط إلى ضبط الخاصية غير المرتبطة بالقيمة الحالية. لن يتمّ إرسال إشعار إلى الكائن لأنّه لم تتغيّر القيمة.
`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(element, index).
`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

الحدث

طرق ثابتة

واجهة MapsEventListener

الطُرق

فئة MVCObject

الشركة المصنِّعة

الطُرق

فئة MVCArray

الشركة المصنِّعة

الطُرق

فعاليات

واجهة ErrorEvent

أماكن إقامة