فئة 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]) المعلّمات:
تنشئ هذه السياسة 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(type, listener[, options]) المعلّمات:
قيمة العرض:
void تعمل هذه الميزة على إعداد دالة سيتم استدعاؤها عند تسليم الحدث المحدّد إلى الهدف. راجع addEventالاستماعer |
addListener |
addListener(eventName, handler) المعلّمات:
قيمة العرض:
MapsEventListener أداة معالجة الأحداث الناتجةلإضافة دالة المستمع هذه إلى اسم الحدث المحدّد في نظام "أحداث الخرائط". |
|
removeEventListener(type, listener[, options]) المعلّمات:
قيمة العرض:
void تتم إزالة أداة معالجة حدث تم تسجيلها سابقًا مع addEventالاستماعين من الهدف. راجِع removeEventالاستماعer |
فعاليات | |
---|---|
click |
function(event) الوسيطات:
يتم تنشيط هذا الحدث عند النقر على العنصر AdvancedMarkerElement .غير متوفرة مع addEventListener() (استخدِم gmp-click بدلاً من ذلك). |
drag |
function(event) الوسيطات:
يتم تنشيط هذا الحدث بشكل متكرر أثناء سحب المستخدم AdvancedMarkerElement .غير متوفرة مع addEventListener() . |
dragend |
function(event) الوسيطات:
يتم تنشيط هذا الحدث عندما يتوقف المستخدم عن سحب AdvancedMarkerElement .غير متوفرة مع addEventListener() . |
dragstart |
function(event) الوسيطات:
يتم تنشيط هذا الحدث عندما يبدأ المستخدم في سحب AdvancedMarkerElement .غير متوفرة مع addEventListener() . |
|
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 مع قيم أقل. بشكل تلقائي، يتم عرض 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")
. اطّلِع على المكتبات في واجهة برمجة تطبيقات 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]) المعلّمات:
|
أماكن إقامة | |
---|---|
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(type, listener[, options]) المعلّمات:
قيمة العرض:
void هذه الدالة ليست متاحة للاستخدام بعد. |
|
removeEventListener(type, listener[, options]) المعلّمات:
قيمة العرض:
void تتم إزالة أداة معالجة حدث تم تسجيلها سابقًا مع addEventالاستماعين من الهدف. راجِع removeEventالاستماعer |
واجهة 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 مقياس الدبوس. |