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.

أماكن إقامة
collisionBehavior	النوع:  CollisionBehavior optional يمكنك الاطّلاع على AdvancedMarkerElementOptions.collisionBehavior.
content	النوع:  Node optional يمكنك الاطّلاع على AdvancedMarkerElementOptions.content.
element	النوع:  HTMLElement هذا الحقل للقراءة فقط. عنصر DOM الذي يدعم العرض
gmpClickable	النوع:  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	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 أداة معالجة الحدث الناتجة. تضيف دالة المستمع المحددة إلى اسم الحدث المحدد في نظام "الأحداث بالخرائط".
removeEventListener	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	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	النوع:  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 يتم عرض جميع 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.

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

واجهة PinElementOptions

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

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