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]) المعلّمات:  options:  AdvancedMarkerElementOptions optional تنشئ هذه السياسة 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	النوع:  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	ملاحظة: هذه الميزة متاحة فقط على v=القناة التجريبية. 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 أداة معالجة الأحداث الناتجة لإضافة دالة المستمع هذه إلى اسم الحدث المحدّد في نظام "أحداث الخرائط".
removeEventListener	ملاحظة: هذه الميزة متاحة فقط على v=القناة التجريبية. removeEventListener(type, listener[, options]) المعلّمات:  type:  string سلسلة تحدِّد نوع الحدث المطلوب إزالة أداة معالجة الحدث له. listener:  EventListener|EventListenerObject أداة معالجة الحدث للمعالج الخاص بالحدث المطلوب إزالته من هدف الحدث. options:  boolean|EventListenerOptions optional الاطّلاع على الخيارات قيمة العرض:  void تتم إزالة أداة معالجة حدث تم تسجيلها سابقًا مع addEventالاستماعين من الهدف. راجِع removeEventالاستماعer

فعاليات
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=القناة التجريبية. 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 السابق فارغًا.
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 مع قيم أقل. بشكل تلقائي، يتم عرض AdvancedMarkerElement وفقًا للوضع العمودي على الشاشة، مع ظهور AdvancedMarkerElement أقل أمام الشاشة AdvancedMarkerElement. يُرجى العِلم أنّه يتم استخدام zIndex أيضًا للمساعدة في تحديد الأولوية النسبية بين علامات CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY المتقدّمة. تشير القيمة zIndex الأعلى إلى أولوية أعلى.

فئة AdvancedMarkerClickEvent

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

ملاحظة: هذه الميزة متاحة فقط على v=القناة التجريبية.

يتم إنشاء هذا الحدث عند النقر على "محدّد موقع متقدم". يمكنك الوصول إلى موضع العلامة باستخدام 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]) المعلّمات:  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=القناة التجريبية. addEventListener(type, listener[, options]) المعلّمات:  type:  string listener:  EventListener|EventListenerObject options:  boolean|AddEventListenerOptions optional قيمة العرض:  void هذه الدالة ليست متاحة للاستخدام بعد.
removeEventListener	ملاحظة: هذه الميزة متاحة فقط على v=القناة التجريبية. 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 مقياس الدبوس.