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 الذي يدعم العرض
BetagmpClickable
النوع:  boolean optional
يمكنك الاطّلاع على BetaAdvancedMarkerElementOptions.gmpClickable.
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])
المَعلمات: 
  • typestring سلسلة حسّاسة لحالة الأحرف تمثّل نوع الحدث المطلوب الاستماع إليه.
  • listenerEventListener|EventListenerObject الكائن الذي يتلقّى إشعارًا. يجب أن يكون هذا دالة أو كائنًا مع طريقة handleEvent
  • optionsboolean|AddEventListenerOptions optional يمكنك الاطّلاع على الخيارات. لا تتوافق الأحداث المخصّصة إلا مع capture وpassive.
قيمة العرض:  void
لإعداد دالة سيتم طلبها عند تسليم الحدث المحدد إلى الهدف. راجِع addEventListener
addListener
addListener(eventName, handler)
المَعلمات: 
  • eventNamestring حدث تمت ملاحظته.
  • handler:  دالة Function للتعامل مع الأحداث.
القيمة المعروضة:  MapsEventListener أداة معالجة الحدث الناتجة.
تضيف دالة المستمع المحددة إلى اسم الحدث المحدد في نظام "الأحداث بالخرائط".
BetaremoveEventListener
removeEventListener(type, listener[, options])
المَعلمات: 
  • typestring سلسلة تحدِّد نوع الحدث المطلوب إزالة أداة معالجة الحدث منه.
  • listenerEventListener|EventListenerObject أداة معالجة الحدث لمعالج الحدث المطلوب إزالتها من هدف الحدث.
  • optionsboolean|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 السابق فارغًا.

BetagmpClickable optional
النوع:  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
لضبط موضع AdvancedMarkerElement. قد يتم إنشاء AdvancedMarkerElement بدون موضع، ولكن لن يتم عرضه إلى أن يتم تحديد موضعه، مثلاً من خلال إجراءات المستخدم أو خياراته. يمكن تحديد موضع AdvancedMarkerElement من خلال ضبط AdvancedMarkerElement.position إذا لم يتم تحديده عند البناء.

ملاحظة: لا يتوافق عمود "AdvancedMarkerElement" مع الارتفاع إلا على خرائط المتّجهات.

title optional
النوع:  string optional
تمرير النص. في حال توفير هذا النص، ستتم إضافة نص لتسهيل الاستخدام (للاستخدام مع برامج قراءة الشاشة مثلاً) إلى AdvancedMarkerElement مع القيمة المقدَّمة.
zIndex optional
النوع:  number optional
يتم عرض جميع AdvancedMarkerElements على الخريطة بترتيب 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])
المَعلمات: 
  • typestring سلسلة تحدِّد نوع الحدث المطلوب إزالة أداة معالجة الحدث منه.
  • listenerEventListener|EventListenerObject أداة معالجة الحدث لمعالج الحدث المطلوب إزالتها من هدف الحدث.
  • optionsboolean|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
مقياس الدبوس.