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]) المَعلمات:  options:  AdvancedMarkerElementOptions optional تنشئ هذه الدالة AdvancedMarkerElement مع الخيارات المحدّدة. في حال تحديد خريطة، تتم إضافة AdvancedMarkerElement إلى الخريطة عند إنشائها.

الخصائص
collisionBehavior	النوع:  CollisionBehavior optional يمكنك الاطّلاع على AdvancedMarkerElementOptions.collisionBehavior.
gmpClickable	النوع:  boolean optional يمكنك الاطّلاع على AdvancedMarkerElementOptions.gmpClickable. سمة HTML: <gmp-advanced-marker gmp-clickable></gmp-advanced-marker>
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.
element	تم إيقافها نهائيًا: استخدِم AdvancedMarkerElement مباشرةً. النوع:  HTMLElement هذا الحقل مخصّص للقراءة فقط. عنصر DOM الذي يستند إليه العرض
content	تم إيقافها نهائيًا: استخدِم .children بدلاً من ذلك. النوع:  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) الوسيطات:  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	ملاحظة: تتوفّر هذه الميزة في قناة الإصدار التجريبي v=beta فقط. function(event) الوسيطات:  event:  AdvancedMarkerClickEvent يتم تنشيط هذا الحدث عند النقر على العنصر AdvancedMarkerElement. يُفضّل استخدامها مع addEventListener() (بدلاً من addListener()).

AdvancedMarkerElementOptions interface

google.maps.marker.AdvancedMarkerElementOptions interface

خيارات إنشاء 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	ملاحظة: تتوفّر هذه الميزة في قناة الإصدار التجريبي v=beta فقط. النوع:  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 يتم عرض جميع AdvancedMarkerElement على الخريطة بترتيب zIndex، مع عرض القيم الأعلى أمام AdvancedMarkerElement ذات القيم الأقل. يتم تلقائيًا عرض AdvancedMarkerElements وفقًا لموضعها العمودي على الشاشة، حيث تظهر AdvancedMarkerElements السفلية أمام AdvancedMarkerElements الأعلى على الشاشة. يُرجى العِلم أنّ 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]) المَعلمات:  options:  PinElementOptions optional

الخصائص
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.

الطُرق
addEventListener	ملاحظة: تتوفّر هذه الميزة في قناة الإصدار التجريبي v=beta فقط. 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 interface

google.maps.marker.PinElementOptions interface

خيارات إنشاء 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 مقياس الدبوس