Advanced Markers

AdvancedMarkerElement

صف واحد (google.maps.marker.AdvancedMarkerElement)

لعرض الموقع على الخريطة. تجدر الإشارة إلى أنّه يجب ضبط 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"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.
AdvancedMarkerElement
AdvancedMarkerElement([options])
المَعلمات: 
تنشئ AdvancedMarkerElement بالخيارات المحددة. إذا تم تحديد خريطة، تتم إضافة AdvancedMarkerElement إلى الخريطة عند البناء.
collisionBehavior
النوع:  CollisionBehavior optional
يمكنك الاطّلاع على AdvancedMarkerElementOptions.collisionBehavior.
content
النوع:  Node optional
يمكنك الاطّلاع على AdvancedMarkerElementOptions.content.
element
النوع:  HTMLElement
هذا الحقل للقراءة فقط. عنصر DOM الاحتياطي للعرض.
gmpDraggable
النوع:  boolean optional
يمكنك الاطّلاع على AdvancedMarkerElementOptions.gmpDraggable.
map
النوع:  Map optional
يمكنك الاطّلاع على AdvancedMarkerElementOptions.map.
position
يمكنك الاطّلاع على 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.
BetaaddEventListener
addEventListener(type, listener[, options])
المَعلمات: 
  • type:  string سلسلة حسّاسة لحالة الأحرف وتمثِّل نوع الحدث المطلوب الاستماع إليه
  • listener:  EventListener|EventListenerObject العنصر الذي يتلقّى إشعارًا يجب أن تكون هذه دالة أو كائنًا باستخدام طريقةhandEvent
  • options:  boolean|AddEventListenerOptions optional يمكنك الاطّلاع على الخيارات. لا تتوافق الأحداث المخصّصة إلّا مع capture وpassive.
قيمة الإرجاع:  void
لإعداد دالة سيتم استدعاؤها كلما تم تسليم الحدث المحدد إلى الهدف. الاطّلاع على addEventListener
addListener
addListener(eventName, handler)
المَعلمات: 
  • eventName:  string حدث تم رصده.
  • handler:  دالة Function لمعالجة الأحداث.
قيمة العرض:  MapsEventListener أداة معالجة الحدث الناتج.
تضيف دالة المستمع المحددة إلى اسم الحدث المعين في نظام الأحداث في الخرائط.
BetaremoveEventListener
removeEventListener(type, listener[, options])
المَعلمات: 
  • type:  string سلسلة تحدِّد نوع الحدث المطلوب إزالة أداة معالجة الحدث منه.
  • listener:  EventListener|EventListenerObject أداة معالجة الحدث لمعالج الحدث المطلوب إزالتها من هدف الحدث.
  • options:  boolean|EventListenerOptions optional الاطّلاع على الخيارات
قيمة الإرجاع:  void
لإزالة أداة معالجة حدث تم تسجيلها سابقًا باستخدام addEventListener من الهدف. راجِع removeEventListener
click
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند النقر على العنصر AdvancedMarkerElement.

غير متوفّر مع addEventListener() (يمكنك استخدام gmp-click بدلاً من ذلك).
drag
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث بشكلٍ متكرر بينما يسحب المستخدم AdvancedMarkerElement.

غير متوفّر مع addEventListener().
dragend
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عندما يتوقّف المستخدم عن سحب AdvancedMarkerElement.

غير متوفّر مع addEventListener().
dragstart
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عندما يبدأ المستخدِم في سحب AdvancedMarkerElement.

غير متوفّر مع addEventListener().
Betagmp-click
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند النقر على العنصر 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 السابق فارغًا.
gmpDraggable optional
النوع:  boolean optional
الخيار التلقائي: false
إذا تم true، يمكن سحب AdvancedMarkerElement.

ملاحظة: الحقل "AdvancedMarkerElement" مع الارتفاع غير قابل للسحب.
map optional
النوع:  Map optional
الخريطة التي سيتم عرض AdvancedMarkerElement عليها الخريطة مطلوبة لعرض AdvancedMarkerElement ويمكن تقديمها من خلال الإعداد AdvancedMarkerElement.map إذا لم يتم توفيرها في البناء.
position optional
لضبط موضع AdvancedMarkerElement. قد يتم إنشاء AdvancedMarkerElement بدون موضع، ولكن لن يتم عرضه إلى أن يتم تحديد موضعه، وذلك من خلال إجراءات المستخدم أو خياراته مثلاً. يمكن توفير موضع AdvancedMarkerElement من خلال الإعداد AdvancedMarkerElement.position إذا لم يتم توفيره في عملية الإنشاء.

ملاحظة: لا تتوفّر ميزة AdvancedMarkerElement ذات الارتفاع إلا على خرائط المتجهات.
title optional
النوع:  string optional
تمرير النص في حال توفيره، ستتم إضافة نص لتسهيل الاستخدام (للاستخدام مع برامج قراءة الشاشة مثلاً) إلى AdvancedMarkerElement مع القيمة المقدّمة.
zIndex optional
النوع:  number optional
يتم عرض جميع AdvancedMarkerElement على الخريطة بترتيب zIndex الخاص بها، مع عرض القيم الأعلى أمام AdvancedMarkerElements ذات القيم الأقل. يتم تلقائيًا عرض أجهزة "AdvancedMarkerElement" وفقًا لموضعها العمودي على الشاشة، مع ظهور قيمة "AdvancedMarkerElement" الأقل أمام AdvancedMarkerElement ثانية في أعلى الشاشة. تجدر الإشارة إلى أنّه يتم استخدام zIndex أيضًا للمساعدة في تحديد الأولوية النسبية بين CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY العلامات المتقدمة. تشير قيمة zIndex الأعلى إلى أولوية أعلى.

AdvancedMarkerClickEvent

صف واحد (google.maps.marker.AdvancedMarkerClickEvent)

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

تمتد هذه الفئة إلى Event.

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

PinElement

صف واحد (google.maps.marker.PinElement)

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

ملاحظة: لا تتوفر حتى الآن إمكانية الاستخدام كمكوِّن ويب (مثل الاستخدام كفئة فرعية في HTMLElement أو عبر HTML).

تمتد هذه الفئة إلى HTMLElement.

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

يمكنك الوصول من خلال الاتصال على الرقم const {PinElement} = await google.maps.importLibrary("marker"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.
PinElement
PinElement([options])
المَعلمات: 
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.
BetaaddEventListener
addEventListener(type, listener[, options])
المَعلمات: 
قيمة الإرجاع:  void
هذه الدالة غير متاحة للاستخدام بعد.
BetaremoveEventListener
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
مقياس الدبوس.