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"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
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 العنصر الذي يتلقّى الإشعارات يجب أن تكون دالة أو كائنًا له طريقة المعالجةEventEvent.
  • options:  boolean|AddEventListenerOptions optional الاطّلاع على الخيارات لا تتيح الأحداث المخصّصة سوى capture وpassive.
قيمة العرض:  void
تعمل هذه الميزة على إعداد دالة سيتم استدعاؤها عند تسليم الحدث المحدّد إلى الهدف. راجع addEventالاستماعer
addListener
addListener(eventName, handler)
المعلّمات: 
  • eventName:  string حدث تمت ملاحظته
  • handler:  Function دالة للتعامل مع الأحداث
قيمة العرض:  MapsEventListener أداة معالجة الأحداث الناتجة
لإضافة دالة المستمع هذه إلى اسم الحدث المحدّد في نظام "أحداث الخرائط".
BetaremoveEventListener
removeEventListener(type, listener[, options])
المعلّمات: 
  • type:  string سلسلة تحدِّد نوع الحدث المطلوب إزالة أداة معالجة الحدث له.
  • listener:  EventListener|EventListenerObject أداة معالجة الحدث للمعالج الخاص بالحدث المطلوب إزالته من هدف الحدث.
  • options:  boolean|EventListenerOptions optional الاطّلاع على الخيارات
قيمة العرض:  void
تتم إزالة أداة معالجة حدث تم تسجيلها سابقًا مع addEventالاستماعين من الهدف. راجِع removeEventالاستماعer
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، مع عرض قيم أعلى أمام AdvancedMarkerElement مع قيم أقل. بشكل تلقائي، يتم عرض 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"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

فئة PinElement

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

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

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

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

ينفّذ هذا الصف PinElementOptions.

يمكنك الوصول من خلال الاتصال بـ const {PinElement} = await google.maps.importLibrary("marker"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
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
تتم إزالة أداة معالجة حدث تم تسجيلها سابقًا مع addEventالاستماعين من الهدف. راجِع removeEventالاستماعer

واجهة 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
مقياس الدبوس.