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.
الشركة المصنِّعة | |
---|---|
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 |
النوع:
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional يمكنك الاطّلاع على
AdvancedMarkerElementOptions.position .سمة HTML:
|
title |
النوع:
string يمكنك الاطّلاع على
AdvancedMarkerElementOptions.title .سمة HTML:
|
zIndex |
النوع:
number optional يمكنك الاطّلاع على AdvancedMarkerElementOptions.zIndex . |
الطُرق | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) المَعلمات:
قيمة الإرجاع:
void لإعداد دالة سيتم استدعاؤها كلما تم تسليم الحدث المحدد إلى الهدف. الاطّلاع على addEventListener |
addListener |
addListener(eventName, handler) المَعلمات:
قيمة العرض:
MapsEventListener أداة معالجة الحدث الناتج.تضيف دالة المستمع المحددة إلى اسم الحدث المعين في نظام الأحداث في الخرائط. |
removeEventListener |
removeEventListener(type, listener[, options]) المَعلمات:
قيمة الإرجاع:
void لإزالة أداة معالجة حدث تم تسجيلها سابقًا باستخدام addEventListener من الهدف. راجِع removeEventListener |
فعاليات | |
---|---|
click |
function(event) الوسيطات:
يتم تنشيط هذا الحدث عند النقر على العنصر AdvancedMarkerElement .غير متوفّر مع addEventListener() (يمكنك استخدام gmp-click بدلاً من ذلك). |
drag |
function(event) الوسيطات:
يتم تنشيط هذا الحدث بشكلٍ متكرر بينما يسحب المستخدم AdvancedMarkerElement .غير متوفّر مع addEventListener() . |
dragend |
function(event) الوسيطات:
يتم تنشيط هذا الحدث عندما يتوقّف المستخدم عن سحب AdvancedMarkerElement .غير متوفّر مع addEventListener() . |
dragstart |
function(event) الوسيطات:
يتم تنشيط هذا الحدث عندما يبدأ المستخدِم في سحب AdvancedMarkerElement .غير متوفّر مع addEventListener() . |
gmp-click |
function(event) الوسيطات:
يتم تنشيط هذا الحدث عند النقر على العنصر AdvancedMarkerElement . يُنصح باستخدامه مع addEventListener() (بدلاً من addListener() ). |
واجهة AdvancedMarkerElementOptions
واجهة google.maps.marker.AdvancedMarkerElementOptions
خيارات إنشاء AdvancedMarkerElement
.
أماكن إقامة | |
---|---|
collisionBehavior optional |
النوع:
CollisionBehavior optional يشير ذلك المصطلح إلى تعداد يحدّد السلوك الذي يجب أن يتّبعه عنصر AdvancedMarkerElement عند اصطدامه بعنصر AdvancedMarkerElement آخر أو مع تصنيفات الخريطة الأساسية على خريطة متجهات. ملاحظة: يعمل تضارب |
content optional |
النوع:
Node optional الخيار التلقائي:
PinElement.element عنصر DOM الاحتياطي لعنصر AdvancedMarkerElement . ملاحظة: لا يستنسخ |
gmpDraggable optional |
النوع:
boolean optional الخيار التلقائي:
false إذا تم true ، يمكن سحب AdvancedMarkerElement . ملاحظة: الحقل " |
map optional |
النوع:
Map optional الخريطة التي سيتم عرض AdvancedMarkerElement عليها الخريطة مطلوبة لعرض AdvancedMarkerElement ويمكن تقديمها من خلال الإعداد AdvancedMarkerElement.map إذا لم يتم توفيرها في البناء. |
position optional |
النوع:
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional لضبط موضع AdvancedMarkerElement . قد يتم إنشاء AdvancedMarkerElement بدون موضع، ولكن لن يتم عرضه إلى أن يتم تحديد موضعه، وذلك من خلال إجراءات المستخدم أو خياراته مثلاً. يمكن توفير موضع AdvancedMarkerElement من خلال الإعداد AdvancedMarkerElement.position إذا لم يتم توفيره في عملية الإنشاء. ملاحظة: لا تتوفّر ميزة |
title optional |
النوع:
string optional تمرير النص في حال توفيره، ستتم إضافة نص لتسهيل الاستخدام (للاستخدام مع برامج قراءة الشاشة مثلاً) إلى AdvancedMarkerElement مع القيمة المقدّمة. |
zIndex optional |
النوع:
number optional يتم عرض جميع AdvancedMarkerElement على الخريطة بترتيب zIndex الخاص بها، مع عرض القيم الأعلى أمام AdvancedMarkerElement s ذات القيم الأقل. يتم تلقائيًا عرض أجهزة "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.
الشركة المصنِّعة | |
---|---|
PinElement |
PinElement([options]) المَعلمات:
|
أماكن إقامة | |
---|---|
background |
النوع:
string optional يمكنك الاطّلاع على PinElementOptions.background . |
borderColor |
النوع:
string optional يمكنك الاطّلاع على PinElementOptions.borderColor . |
element |
النوع:
HTMLElement هذا الحقل للقراءة فقط. عنصر DOM الاحتياطي للعرض. |
glyph |
يمكنك الاطّلاع على PinElementOptions.glyph . |
glyphColor |
النوع:
string optional يمكنك الاطّلاع على PinElementOptions.glyphColor . |
scale |
النوع:
number optional يمكنك الاطّلاع على PinElementOptions.scale . |
الطُرق | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) المَعلمات:
قيمة الإرجاع:
void هذه الدالة غير متاحة للاستخدام بعد. |
removeEventListener |
removeEventListener(type, listener[, options]) المَعلمات:
قيمة الإرجاع:
void لإزالة أداة معالجة حدث تم تسجيلها سابقًا باستخدام addEventListener من الهدف. راجِع removeEventListener |
واجهة PinElementOptions
واجهة google.maps.marker.PinElementOptions
خيارات إنشاء PinElement
أماكن إقامة | |
---|---|
background optional |
النوع:
string optional لون خلفية شكل الدبوس. تتوافق مع أي قيمة لون CSS. |
borderColor optional |
النوع:
string optional لون حدود شكل الدبوس. تتوافق مع أي قيمة لون CSS. |
glyph optional |
عنصر DOM المعروض في الدبوس. |
glyphColor optional |
النوع:
string optional لون الحرف الرسومي. تتوافق مع أي قيمة لون CSS. |
scale optional |
النوع:
number optional الخيار التلقائي:
1 مقياس الدبوس. |