Advanced Markers

فئة AdvancedMarkerElement

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

يعرض موقعًا جغرافيًا على الخريطة. يُرجى العِلم أنّه يجب ضبط السمة position ليتم عرض السمة AdvancedMarkerElement.

العنصر المخصّص:
<gmp-advanced-marker anchor-left="string" anchor-top="string" 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 إلى الخريطة عند الإنشاء.

الخصائص
anchorLeft	النوع:  string optional الإعداد التلقائي: "‎-50%" قيمة نسبة طول CSS تُستخدَم لإزاحة نقطة الارتساء الخاصة بالعلامة من الزاوية العلوية اليمنى للعلامة. ويكون ذلك مفيدًا عند استخدام عنصر مرئي يحتوي على نقطة ارتساء تختلف عن نقطة المنتصف السفلية المعتادة للعلامة التلقائية. سمة HTML: <gmp-advanced-marker anchor-left="string"></gmp-advanced-marker>
anchorTop	النوع:  string optional القيمة التلقائية: "‎-100%" قيمة نسبة طول CSS تُستخدَم لإزاحة نقطة الارتساء الخاصة بالعلامة من الزاوية العلوية اليمنى للعلامة. ويكون ذلك مفيدًا عند استخدام عنصر مرئي يحتوي على نقطة ارتساء تختلف عن نقطة المنتصف السفلية المعتادة للعلامة التلقائية. سمة HTML: <gmp-advanced-marker anchor-top="string"></gmp-advanced-marker>
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 متتبِّع الأحداث الناتج تضيف هذه الدالة وظيفة أداة معالجة الحدث المحدّدة إلى اسم الحدث المحدّد في نظام Maps Eventing.
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	function(event) الوسيطات:  event:  AdvancedMarkerClickEvent يتم تنشيط هذا الحدث عند النقر على العنصر AdvancedMarkerElement. يُفضَّل استخدامها مع addEventListener() (بدلاً من addListener()).

واجهة AdvancedMarkerElementOptions

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

خيارات إنشاء AdvancedMarkerElement

الخصائص
anchorLeft optional	النوع:  string optional الإعداد التلقائي: "‎-50%" قيمة نسبة طول CSS تُستخدَم لإزاحة نقطة الارتساء الخاصة بالعلامة من الزاوية العلوية اليمنى للعلامة. ويكون ذلك مفيدًا عند استخدام عنصر مرئي يحتوي على نقطة ارتساء تختلف عن نقطة المنتصف السفلية المعتادة للعلامة التلقائية.
anchorTop optional	النوع:  string optional القيمة التلقائية: "‎-100%" قيمة نسبة طول CSS تُستخدَم لإزاحة نقطة الارتساء الخاصة بالعلامة من الزاوية العلوية اليمنى للعلامة. ويكون ذلك مفيدًا عند استخدام عنصر مرئي يحتوي على نقطة ارتساء تختلف عن نقطة المنتصف السفلية المعتادة للعلامة التلقائية.
collisionBehavior optional	النوع:  CollisionBehavior optional تعداد يحدّد سلوك AdvancedMarkerElement عند تداخله مع AdvancedMarkerElement آخر أو مع تصنيفات الخريطة الأساسية على خريطة اتجاهية. ملاحظة: يعمل تداخل AdvancedMarkerElement مع AdvancedMarkerElement على كلّ من الخرائط النقطية والاتجاهية، ولكنّ تداخل AdvancedMarkerElement مع تصنيف الخريطة الأساسية يعمل على الخرائط الاتجاهية فقط.
content optional	النوع:  Node optional القيمة التلقائية: PinElement عنصر DOM الذي يدعم العنصر المرئي لـ AdvancedMarkerElement. ملاحظة: لا ينسخ AdvancedMarkerElement عنصر DOM الذي تم تمريره. بعد تمرير عنصر DOM إلى AdvancedMarkerElement، سيؤدي تمرير عنصر DOM نفسه إلى AdvancedMarkerElement آخر إلى نقل عنصر DOM وجعل AdvancedMarkerElement السابق يبدو فارغًا.
gmpClickable optional	النوع:  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 ذات القيم الأقل. يتم تلقائيًا عرض 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 أو Marker3DElement التلقائي. الرمز هو عنصر DOM اختياري يتم عرضه في شكل بالون. قد تختلف نسبة العرض إلى الارتفاع في PinElement حسب PinElement.scale.

هذه الفئة هي امتداد لـ 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.
glyphColor	النوع:  string optional يمكنك الاطّلاع على PinElementOptions.glyphColor.
glyphSrc	النوع:  URL|string optional يمكنك الاطّلاع على PinElementOptions.glyphSrc.
glyphText	النوع:  string optional يمكنك الاطّلاع على PinElementOptions.glyphText.
scale	النوع:  number optional يمكنك الاطّلاع على PinElementOptions.scale.
element	متوقفة نهائيًا: استخدِم PinElement مباشرةً. النوع:  HTMLElement هذا الحقل متاح للقراءة فقط. عنصر DOM الذي يدعم العرض
glyph	متوقفة نهائيًا: يُرجى استخدام PinElementOptions.glyphText أو PinElementOptions.glyphSrc بدلاً منها. النوع:  string|Element|URL optional يمكنك الاطّلاع على PinElementOptions.glyph.

الطُرق
addEventListener	addEventListener(type, listener[, options]) المَعلمات:  ‫type:  string سلسلة حسّاسة لحالة الأحرف تمثّل نوع الحدث المطلوب الاستماع إليه. ‫listener:  EventListener|EventListenerObject الكائن الذي يتلقّى إشعارًا يجب أن تكون هذه دالة أو كائنًا باستخدام طريقة handleEvent ‫options:  boolean|AddEventListenerOptions optional يمكنك الاطّلاع على الخيارات. لا تتيح الأحداث المخصّصة سوى capture وpassive. القيمة المعروضة:  void يتم إعداد دالة يتم استدعاؤها كلما تم تسليم الحدث المحدّد إلى الهدف. يُرجى الاطّلاع على addEventListener.
removeEventListener	removeEventListener(type, listener[, options]) المَعلمات:  ‫type:  string سلسلة تحدّد نوع الحدث الذي تريد إزالة متتبِّع الأحداث له. ‫listener:  EventListener|EventListenerObject متتبِّع الأحداث الخاص بمعالج الأحداث المطلوب إزالته من هدف الحدث ‫options:  boolean|EventListenerOptions optional يمكنك الاطّلاع على الخيارات. القيمة المعروضة:  void تزيل هذه الطريقة متتبِّع الأحداث الذي تم تسجيله سابقًا باستخدام addEventListener من الهدف. يُرجى الاطّلاع على removeEventListener.

واجهة PinElementOptions

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

خيارات إنشاء PinElement

الخصائص
background optional	النوع:  string optional لون خلفية شكل الدبوس تتيح هذه السمة استخدام أي قيمة لون في CSS.
borderColor optional	النوع:  string optional لون حدود شكل الدبوس تتيح هذه السمة استخدام أي قيمة لون في CSS.
glyph optional	متوقفة نهائيًا: يُرجى استخدام PinElementOptions.glyphText أو PinElementOptions.glyphSrc بدلاً منها. النوع:  string|Element|URL optional عنصر DOM المعروض في الدبوس
glyphColor optional	النوع:  string optional لون الرمز تتيح هذه السمة استخدام أي قيمة لون في CSS.
glyphSrc optional	النوع:  URL|string optional مصدر صورة الرمز التي سيتم عرضها في الدبوس
glyphText optional	النوع:  string optional النص المعروض في الدبوس.
scale optional	النوع:  number optional القيمة التلقائية: 1 مقياس الدبوس