Advanced Markers

فئة AdvancedMarkerElement

google.maps.marker.AdvancedMarkerElement صف

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

العنصر المخصّص:
<gmp-advanced-marker gmp-clickable 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.
gmpClickable
النوع:  boolean optional
يمكنك الاطّلاع على BetaAdvancedMarkerElementOptions.gmpClickable.
سمة HTML:
  • <gmp-advanced-marker gmp-clickable></gmp-advanced-marker>
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.
element
النوع:  HTMLElement
هذا الحقل مخصّص للقراءة فقط. عنصر DOM الذي يستند إليه العرض
content
النوع:  Node optional
يمكنك الاطّلاع على AdvancedMarkerElementOptions.content.
addEventListener
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
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 interface

google.maps.marker.AdvancedMarkerElementOptions interface

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