Advanced Markers (beta)

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

فئة AdvancedMarkerView

google.maps.marker.AdvancedMarkerView الصف الدراسي

لإنشاء AdvancedMarkerView مع تحديد الخيارات. إذا تم تحديد خريطة، تتم إضافة AdvancedMarkerView إلى الخريطة عند الإنشاء. لاحظ أنه يجب تعيين الموضع لكي يتم عرض AdvancedMarkerView.

ينفِّذ هذا الصف AdvancedMarkerViewOptions.

تحميل باستخدام معلمة عنوان URL &libraries=marker. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {AdvancedMarkerView} = await google.map.importLibrary("marker"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
AdvancedMarkerView
AdvancedMarkerView([options])
المعلّمات:
collisionBehavior
النوع: CollisionBehavior optional
يمكنك الاطّلاع على AdvancedMarkerViewOptions.collisionBehavior.
content
النوع: Element optional
يمكنك الاطّلاع على AdvancedMarkerViewOptions.content.
draggable
النوع: boolean optional
يمكنك الاطّلاع على AdvancedMarkerViewOptions.draggable.
element optional
النوع: HTMLElement|SVGElement optional
هذا الحقل للقراءة فقط. عنصر DOM الذي يدعم العرض.
map
النوع: Map optional
يمكنك الاطّلاع على AdvancedMarkerViewOptions.map.
position
يمكنك الاطّلاع على AdvancedMarkerViewOptions.position.
title
النوع: string optional
يمكنك الاطّلاع على AdvancedMarkerViewOptions.title.
zIndex
النوع: number optional
يمكنك الاطّلاع على AdvancedMarkerViewOptions.zIndex.
addListener
addListener(eventName, handler)
المعلّمات:
قيمة الإرجاع: MapsEventListener
لإضافة وظيفة المستمع المحددة إلى اسم الحدث المحدد.
click
function(event)
الوسيطات:
يتم تشغيل هذا الحدث عند النقر على العنصر AdvancedMarkerView.
drag
function(event)
الوسيطات:
يتم تنشيط هذا الحدث بشكل متكرر أثناء سحب المستخدم لـ AdvancedMarkerView.
dragend
function(event)
الوسيطات:
يتم تنشيط هذا الحدث عندما يتوقف المستخدم عن سحب AdvancedMarkerView.
dragstart
function(event)
الوسيطات:
يتم تنشيط هذا الحدث عندما يبدأ المستخدم في سحب AdvancedMarkerView.

AdvancedMarkerViewOptions واجهة

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

خيارات لإنشاء AdvancedMarkerView.
collisionBehavior optional
النوع: CollisionBehavior optional
تعداد يحدد الطريقة التي يجب أن يتصرف بها AdvancedMarkerView عند اصطدامه بـ AdvancedMarkerView آخر أو بتصنيفات الخريطة الأساسية على خريطة متجه.

ملاحظة: يعمل التضارب من AdvancedMarkerView إلى AdvancedMarkerView على الخرائط النقطية والمتّجهين، ومع ذلك، يعمل AdvancedMarkerView إلى تصادم تصنيف الخريطة الأساسية على الخرائط الموجّهة فقط.
content optional
النوع: Element optional
تلقائي: PinView.element
يشير عنصر DOM إلى النسخة المرئية من AdvancedMarkerView.

ملاحظة: لا يستنسخ AdvancedMarkerView عنصر DOM الذي تم تمريره. بعد تمرير عنصر DOM إلى AdvancedMarkerView، سيؤدي تمرير عنصر DOM نفسه إلى AdvancedMarkerView آخر إلى نقل عنصر DOM وجعل عنصر AdvancedMarkerView السابق يبدو فارغًا.
draggable optional
النوع: boolean optional
تلقائي: false
إذا true، فيمكن سحب AdvancedMarkerView.

ملاحظة: AdvancedMarkerView مع الارتفاع غير قابل للسحب.
element optional
النوع: HTMLElement|SVGElement optional
هذا الحقل للقراءة فقط. عنصر DOM الذي يدعم العرض.
map optional
النوع: Map optional
الخريطة التي سيتم عرض AdvancedMarkerView عليها. الخريطة مطلوبة لعرض AdvancedMarkerView ويمكن توفيرها عن طريق تعيين AdvancedMarkerView.map إذا لم يتم توفيرها أثناء الإنشاء.
position optional
لتعيين موضع AdvancedMarkerView. قد يتم إنشاء AdvancedMarkerView بدون موضع، ولكن لن يتم عرضه إلى أن يتم تقديم موضعه، مثلاً من خلال إجراءات المستخدم أو خياراته. يمكن تقديم موضع AdvancedMarkerView من خلال ضبط AdvancedMarkerView.position إذا لم يتم تقديمه عند الإنشاء.

ملاحظة: يمكن استخدام AdvancedMarkerView ذات الارتفاع على خرائط المتجهات فقط.
title optional
النوع: string optional
تمرير الماوس فوق النص. في حال توفّره، ستتم إضافة نص إمكانية الوصول (على سبيل المثال للاستخدام مع برامج قراءة الشاشة) إلى AdvancedMarkerView مع القيمة المقدمة.
zIndex optional
النوع: number optional
يتم عرض جميع AdvancedMarkerView على الخريطة بترتيب مؤشر z، مع عرض قيم أعلى أمام AdvancedMarkerView بقيم أقل. يتم عرض AdvancedMarkerView ثانية تلقائيًا وفقًا لموضعها الرأسي على الشاشة، مع ظهور AdvancedMarkerView أقل أمام AdvancedMarkerView أبعد من الشاشة. لاحظ أن zIndex يُستخدم أيضًا للمساعدة في تحديد الأولوية النسبية بين CollisionBehavior.OPTIONAL_AND_HIDES_LOWER_PRIORITY علامات متقدمة. تشير القيمة zIndex الأعلى إلى أولوية أعلى.

فئة PinView

google.maps.marker.PinView الصف الدراسي

يمثل PinView عنصر DOM الذي يتكون من شكل وحرف رسومي. يستخدم الشكل نفس نمط البالون كما هو موضح في AdvancedMarkerView التلقائية. الحرف الرسومي هو عنصر DOM اختياري يتم عرضه على شكل بالون. قد تختلف نسبة العرض إلى الارتفاع لـ PinView حسب PinView.scale.

ينفِّذ هذا الصف PinViewOptions.

تحميل باستخدام معلمة عنوان URL &libraries=marker. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {PinView} = await google.map.importLibrary("marker"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
PinView
PinView([options])
المعلّمات:
background
النوع: string optional
يمكنك الاطّلاع على PinViewOptions.background.
borderColor
النوع: string optional
يمكنك الاطّلاع على PinViewOptions.borderColor.
element optional
النوع: HTMLElement|SVGElement optional
هذا الحقل للقراءة فقط. عنصر DOM الذي يدعم العرض.
glyph
النوع: string|Element|URL optional
يمكنك الاطّلاع على PinViewOptions.glyph.
glyphColor
النوع: string optional
يمكنك الاطّلاع على PinViewOptions.glyphColor.
scale
النوع: number optional
يمكنك الاطّلاع على PinViewOptions.scale.
addListener
addListener(eventName, handler)
المعلّمات:
قيمة الإرجاع: MapsEventListener
لإضافة وظيفة المستمع المحددة إلى اسم الحدث المحدد.

PinViewOptions واجهة

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

خيارات إنشاء PinView.
background optional
النوع: string optional
لون خلفية شكل الدبوس. تتوافق مع أي قيمة لون في CSS.
borderColor optional
النوع: string optional
لون حد شكل الدبوس. تتوافق مع أي قيمة لون في CSS.
element optional
النوع: HTMLElement|SVGElement optional
هذا الحقل للقراءة فقط. عنصر DOM الذي يدعم العرض.
glyph optional
النوع: string|Element|URL optional
يتم عرض عنصر DOM في الدبوس.
glyphColor optional
النوع: string optional
لون الحرف الرسومي. تتوافق مع أي قيمة لون في CSS.
scale optional
النوع: number optional
تلقائي: 1
مقياس الدبوس.