Advanced Markers

فئة AdvancedMarkerElement

google.maps.marker.AdvancedMarkerElement class

تعرِض هذه السمة موضعًا على الخريطة. يُرجى العِلم أنّه يجب ضبط position لكي يظهر AdvancedMarkerElement.

ملاحظة: لا يتوفّر استخدام العنصر كعنصر ويب (مثل استخدام عنصر HTML المخصّص <gmp-advanced-marker>) إلا في قناة v=beta.

العنصر المخصّص:
<gmp-advanced-marker position="lat,lng" title="string"></gmp-advanced-marker>

يمتدّ هذا الصف إلى HTMLElement.

تنفّذ هذه الفئة AdvancedMarkerElementOptions.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {AdvancedMarkerElement} = await google.maps.importLibrary("marker"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الشركة المصنِّعة
AdvancedMarkerElement	AdvancedMarkerElement([options]) المَعلمات:  options:  AdvancedMarkerElementOptions optional تنشئ هذه الدالة AdvancedMarkerElement بالاستناد إلى الخيارات المحدّدة. في حال تحديد خريطة، تتم إضافة AdvancedMarkerElement إلى الخريطة عند إنشاء العنصر.

الخصائص
collisionBehavior	النوع:  CollisionBehavior optional يمكنك الاطّلاع على AdvancedMarkerElementOptions.collisionBehavior.
content	النوع:  Node optional يمكنك الاطّلاع على AdvancedMarkerElementOptions.content.
element	النوع:  HTMLElement هذا الحقل للقراءة فقط. عنصر نموذج عناصر المستند (DOM) الذي يدعم طريقة العرض
gmpClickable	ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta. النوع:  boolean optional يمكنك الاطّلاع على AdvancedMarkerElementOptions.gmpClickable.
gmpDraggable	النوع:  boolean optional يمكنك الاطّلاع على AdvancedMarkerElementOptions.gmpDraggable.
map	النوع:  Map optional يمكنك الاطّلاع على AdvancedMarkerElementOptions.map.
position	النوع:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional يمكنك الاطّلاع على AdvancedMarkerElementOptions.position. سمة HTML: <gmp-advanced-marker position="lat,lng"></gmp-advanced-marker> <gmp-advanced-marker position="lat,lng,altitude"></gmp-advanced-marker>
title	النوع:  string يمكنك الاطّلاع على AdvancedMarkerElementOptions.title. سمة HTML: <gmp-advanced-marker title="string"></gmp-advanced-marker>
zIndex	النوع:  number optional يمكنك الاطّلاع على AdvancedMarkerElementOptions.zIndex.

الطُرق
addEventListener	ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta. addEventListener(type, listener[, options]) المَعلمات:  type:  string سلسلة حسّاسة لحالة الأحرف تمثّل نوع الحدث الذي تريد الاستماع إليه. listener:  EventListener|EventListenerObject العنصر الذي يتلقّى إشعارًا. يجب أن يكون هذا العنصر دالة أو كائنًا يتضمّن طريقة handleEvent. options:  boolean|AddEventListenerOptions optional اطّلِع على الخيارات. لا تتيح الأحداث المخصّصة سوى capture وpassive. القيمة المعروضة:  void تُستخدَم لإعداد دالة سيتمّ استدعاؤها عند إرسال الحدث المحدّد إلى الهدف. راجِع addEventListener.
addListener	addListener(eventName, handler) المَعلمات:  eventName:  string الحدث المرصود handler:  Function وظيفة لمعالجة الأحداث القيمة المعروضة:  MapsEventListener أداة معالجة الحدث الناتجة. تُضيف وظيفة أداة مراقبة الأحداث المحدّدة إلى اسم الحدث المحدّد في نظام الأحداث في "خرائط Google".
removeEventListener	ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta. removeEventListener(type, listener[, options]) المَعلمات:  type:  string سلسلة تحدّد نوع الحدث الذي يجب إزالة مستمع الحدث له. listener:  EventListener|EventListenerObject أداة معالجة الحدث المطلوب إزالتها من هدف الحدث options:  boolean|EventListenerOptions optional اطّلِع على الخيارات. القيمة المعروضة:  void تزيل هذه الوظيفة أداة معالجة حدث مسجَّلة سابقًا باستخدام addEventListener من الهدف. راجِع removeEventListener.

الفعاليات
click	function(event) الوسيطات:  event:  MapMouseEvent يتم تنشيط هذا الحدث عند النقر على العنصر AdvancedMarkerElement. لا يتوفّر مع addEventListener() (استخدِم gmp-click بدلاً منه).
drag	function(event) الوسيطات:  event:  MapMouseEvent يتم تشغيل هذا الحدث بشكل متكرّر بينما يسحب المستخدم الرمز AdvancedMarkerElement. لا يتوفّر مع addEventListener().
dragend	function(event) الوسيطات:  event:  MapMouseEvent يتم تشغيل هذا الحدث عندما يتوقف المستخدم عن سحب AdvancedMarkerElement. لا يتوفّر مع addEventListener().
dragstart	function(event) الوسيطات:  event:  MapMouseEvent يتم تشغيل هذا الحدث عندما يبدأ المستخدم سحب AdvancedMarkerElement. لا يتوفّر مع addEventListener().
gmp-click	ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta. function(event) الوسيطات:  event:  AdvancedMarkerClickEvent يتم تنشيط هذا الحدث عند النقر على العنصر AdvancedMarkerElement. يُفضَّل استخدامها مع addEventListener() (بدلاً من addListener()).

واجهة AdvancedMarkerElementOptions

google.maps.marker.AdvancedMarkerElementOptions واجهة

خيارات إنشاء AdvancedMarkerElement

الخصائص
collisionBehavior optional	النوع:  CollisionBehavior optional قائمة تحدد كيفية سلوك AdvancedMarkerElement عند تصادمه مع AdvancedMarkerElement آخر أو مع تصنيفات الخريطة الأساسية على خريطة متجه ملاحظة: تعمل تصادمات AdvancedMarkerElement إلى AdvancedMarkerElement على كل من الخرائط النقطية والمتجهة، ولكن لا تعمل تصادمات تصنيف AdvancedMarkerElement إلى الخريطة الأساسية إلا على الخرائط المتّجهية.
content optional	النوع:  Node optional القيمة التلقائية: PinElement.element عنصر DOM الذي يدعم المرئيات في AdvancedMarkerElement ملاحظة: لا تُنشئ دالة AdvancedMarkerElement نسخة طبق الأصل من عنصر DOM الذي تم تمريره. بعد تمرير عنصر نموذج DOM إلى AdvancedMarkerElement، سيؤدي تمرير عنصر نموذج DOM نفسه إلى AdvancedMarkerElement آخر إلى نقل عنصر نموذج DOM وسيؤدي إلى ظهور AdvancedMarkerElement السابق فارغًا.
gmpClickable optional	ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta. النوع:  boolean optional القيمة التلقائية: false إذا كان true، سيكون AdvancedMarkerElement قابلاً للنقر وسيؤدي إلى تشغيل الحدث gmp-click، وسيكون تفاعليًا لأغراض تسهيل الاستخدام (مثل السماح بالتنقّل باستخدام لوحة المفاتيح من خلال مفاتيح الأسهم).
gmpDraggable optional	النوع:  boolean optional القيمة التلقائية: false إذا كان true، يمكن سحب AdvancedMarkerElement. ملاحظة: لا يمكن سحب AdvancedMarkerElement مع الارتفاع.
map optional	النوع:  Map optional الخريطة التي سيتم عرض AdvancedMarkerElement عليها يجب أن تعرض الخريطة AdvancedMarkerElement ويمكن تقديمها من خلال ضبط AdvancedMarkerElement.map إذا لم يتم تقديمها في مرحلة الإنشاء.
position optional	النوع:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional تُستخدَم لضبط موضع AdvancedMarkerElement. يمكن إنشاء AdvancedMarkerElement بدون موضع، ولكن لن يتم عرضه إلى أن يتم تقديم موضعه، على سبيل المثال، من خلال إجراءات أو خيارات المستخدم. يمكن توفير موضع AdvancedMarkerElement من خلال ضبط AdvancedMarkerElement.position إذا لم يتم توفيره في عملية الإنشاء. ملاحظة: لا يمكن استخدام AdvancedMarkerElement مع الارتفاع إلا على الخرائط المستندة إلى المتجهات.
title optional	النوع:  string optional نص التمرير في حال توفّر نص تسهيل الاستخدام (مثلاً للاستخدام مع تطبيقات قراءة الشاشة)، ستتم إضافته إلى AdvancedMarkerElement بالقيمة المقدَّمة.
zIndex optional	النوع:  number optional يتم عرض جميع AdvancedMarkerElement على الخريطة بترتيب zIndex، مع عرض القيم الأعلى أمام AdvancedMarkerElement ذات القيم الأقل. يتم تلقائيًا عرض AdvancedMarkerElement وفقًا لموقعها العمودي على الشاشة، مع ظهور AdvancedMarkerElement السفلية أمام AdvancedMarkerElement في أعلى الشاشة. يُرجى العلم أنّه يتم استخدام zIndex أيضًا للمساعدة في تحديد الأولوية النسبية بين CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY العلامات المتقدّمة. تشير القيمة الأعلى zIndex إلى أولوية أعلى.

AdvancedMarkerClickEvent class

google.maps.marker.AdvancedMarkerClickEvent class

ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta.

يتم إنشاء هذا الحدث من خلال النقر على علامة متقدّمة. يمكنك الوصول إلى موضع العلامة باستخدام event.target.position.

يمتدّ هذا الصف إلى Event.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {AdvancedMarkerClickEvent} = await google.maps.importLibrary("marker"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

فئة PinElement

google.maps.marker.PinElement class

يمثّل الرمز PinElement عنصر DOM يتألّف من شكل ورمز مميّز. يتضمّن الشكل نمط البالون نفسه المعروض في الرمز التلقائي AdvancedMarkerElement. الرمز النصي هو عنصر اختياري في نموذج DOM يتم عرضه على شكل بالون. قد يكون لـ PinElement نسبة عرض إلى ارتفاع مختلفة حسب PinElement.scale.

ملاحظة: لا يمكن استخدامها كعنصر ويب (مثلاً، الاستخدام كصنف فرعي من HTMLElement أو من خلال HTML).

يمتدّ هذا الصف إلى HTMLElement.

تنفّذ هذه الفئة PinElementOptions.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {PinElement} = await google.maps.importLibrary("marker"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الشركة المصنِّعة
PinElement	PinElement([options]) المَعلمات:  options:  PinElementOptions optional

الخصائص
background	النوع:  string optional يمكنك الاطّلاع على PinElementOptions.background.
borderColor	النوع:  string optional يمكنك الاطّلاع على PinElementOptions.borderColor.
element	النوع:  HTMLElement هذا الحقل للقراءة فقط. عنصر نموذج عناصر المستند (DOM) الذي يدعم طريقة العرض
glyph	النوع:  string|Element|URL optional يمكنك الاطّلاع على PinElementOptions.glyph.
glyphColor	النوع:  string optional يمكنك الاطّلاع على PinElementOptions.glyphColor.
scale	النوع:  number optional يمكنك الاطّلاع على PinElementOptions.scale.

الطُرق
addEventListener	ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta. addEventListener(type, listener[, options]) المَعلمات:  type:  string listener:  EventListener|EventListenerObject options:  boolean|AddEventListenerOptions optional القيمة المعروضة:  void هذه الدالة غير متاحة للاستخدام بعد.
removeEventListener	ملاحظة: لا تتوفّر هذه الميزة إلا في قناة v=beta. removeEventListener(type, listener[, options]) المَعلمات:  type:  string سلسلة تحدّد نوع الحدث الذي يجب إزالة مستمع الحدث له. listener:  EventListener|EventListenerObject أداة معالجة الحدث المطلوب إزالتها من هدف الحدث options:  boolean|EventListenerOptions optional اطّلِع على الخيارات. القيمة المعروضة:  void تزيل هذه الوظيفة أداة معالجة حدث مسجَّلة سابقًا باستخدام addEventListener من الهدف. راجِع removeEventListener.

واجهة PinElementOptions

google.maps.marker.PinElementOptions واجهة

خيارات إنشاء PinElement

الخصائص
background optional	النوع:  string optional لون خلفية شكل الدبوس تتيح استخدام أي قيمة لون في CSS.
borderColor optional	النوع:  string optional لون حدود شكل الدبوس تتيح استخدام أي قيمة لون في CSS.
glyph optional	النوع:  string|Element|URL optional عنصر نموذج عناصر المستند (DOM) المعروض في الدبوس
glyphColor optional	النوع:  string optional لون الرمز. تتيح استخدام أي قيمة لون في CSS.
scale optional	النوع:  number optional القيمة التلقائية: 1 مقياس الدبوس