Marker

فئة المُحدِّد

صف واحد (google.maps.Marker)

يمتد هذا الصف MVCObject.

يمكنك الوصول من خلال الاتصال بـ const {Marker} = await google.maps.importLibrary("marker"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

Marker
Marker([opts])
المعلّمات: 
  • optsMarkerOptions optional وسيطات اختيارية مُسمّاة
يعمل على إنشاء علامة باستخدام الخيارات المحدّدة. وفي حال تحديد خريطة، تتم إضافة العلامة إلى الخريطة عند تنفيذ عملية الإنشاء. يُرجى العلم بأنه يجب ضبط الموضع ليتم عرض العلامة.
getAnimation
getAnimation()
المعلّمات: بدون
قيمة العرض:  Animation|null|undefined
الحصول على الصورة المتحركة التي يتم تشغيلها حاليًا
getClickable
getClickable()
المعلّمات: بدون
عرض القيمة:  boolean صحيح إذا كانت العلامة أداة قابلة للنقر.
الاطّلاع على حالة Marker القابلة للنقر
getCursor
getCursor()
المعلّمات: بدون
قيمة العرض:  string|null|undefined
يمكنك الحصول على نوع مؤشر الماوس عند التمرير.
getDraggable
getDraggable()
المعلّمات: بدون
قيمة العرض:  boolean صحيحة إذا كانت العلامة هي قابلة للسحب.
يمكنك الحصول على الحالة القابلة للسحب من Marker.
getIcon
getIcon()
المعلّمات: بدون
قيمة العرض:  string|Icon|Symbol|null|undefined
الحصول على رمز Marker. يمكنك الاطّلاع على MarkerOptions.icon.
getLabel
getLabel()
المعلّمات: بدون
قيمة العرض:  MarkerLabel|string|null|undefined
احصل على تصنيف Marker. يمكنك الاطّلاع على MarkerOptions.label.
getMap
getMap()
المعلّمات: بدون
قيمة العرض:  Map|StreetViewPanorama
يمكنك الحصول على الخريطة أو البانوراما التي يتم عرض Marker عليها.
getOpacity
getOpacity()
المعلّمات: بدون
قيمة العرض:  number|null|undefined رقم بين 0.0 و1.0.
يمكنك الحصول على تعتيم Marker.
getPosition
getPosition()
المعلّمات: بدون
قيمة العرض:  LatLng|null|undefined
يُرجى الحصول على موضع Marker.
getShape
getShape()
المعلّمات: بدون
قيمة العرض:  MarkerShape|null|undefined
حدِّد شكل Marker المستخدَم للتفاعل. يمكنك الاطّلاع على MarkerOptions.shape وMarkerShape.
getTitle
getTitle()
المعلّمات: بدون
قيمة العرض:  string|null|undefined
احصل على عنوان تلميح Marker. يمكنك الاطّلاع على MarkerOptions.title.
getVisible
getVisible()
المعلّمات: بدون
قيمة العرض:  boolean صحيح إذا كانت العلامة ظاهرة.
الحصول على إذن بالوصول إلى Marker.
getZIndex
getZIndex()
المعلّمات: بدون
قيمة الإرجاع:  number|null|undefined zفهرس أداة التحديد.
عليك الحصول على فهرس z في Marker. يمكنك الاطّلاع على MarkerOptions.zIndex.
setAnimation
setAnimation([animation])
المعلّمات: 
  • animationAnimation optional الصورة المتحركة المطلوب تشغيلها
قيمة العرض: بدون
افتح صورة متحركة. وسيتم إلغاء أيّ صورة متحركة مستمرة. الصور المتحركة المتوافقة حاليًا: Animation.BOUNCE وAnimation.DROP. سيؤدي تمرير null إلى إيقاف أي صورة متحركة.
setClickable
setClickable(flag)
المعلّمات: 
  • flagboolean إذا كانت true، يمكن النقر على "أداة التحديد".
قيمة العرض: بدون
حدِّد ما إذا كان Marker قابلاً للنقر.
setCursor
setCursor([cursor])
المعلّمات: 
  • cursorstring optional نوع مؤشر الماوس
قيمة العرض: بدون
اضبط نوع مؤشر الماوس عند التمرير.
setDraggable
setDraggable(flag)
المعلّمات: 
  • flagboolean optional إذا true، يمكن سحب محدّد الموقع.
قيمة العرض: بدون
يمكنك ضبط ما إذا كان Marker قابلاً للسحب.
setIcon
setIcon([icon])
المعلّمات: 
قيمة العرض: بدون
اضبط الرمز لـ Marker. يمكنك الاطّلاع على MarkerOptions.icon.
setLabel
setLabel([label])
المعلّمات: 
  • labelstring|MarkerLabel optional يمكن أن يكون التصنيف سلسلة أحرف أو عنصر MarkerLabel.
قيمة العرض: بدون
ضبط تصنيف Marker. يمكنك الاطّلاع على MarkerOptions.label.
setMap
setMap(map)
المعلّمات: 
قيمة العرض: بدون
يتم عرض Marker على الخريطة أو البانوراما المحددة. إذا تم ضبط الخريطة على null، ستتم إزالة العلامة.
setOpacity
setOpacity([opacity])
المعلّمات: 
  • opacitynumber optional رقم بين 0.0 وشفاف و1.0، مبهم
قيمة العرض: بدون
يمكنك ضبط تعتيم Marker.
setOptions
setOptions(options)
المعلّمات: 
قيمة العرض: بدون
حدِّد خيارات Marker.
setPosition
setPosition([latlng])
المعلّمات: 
قيمة العرض: بدون
يمكنك ضبط قائمة Marker.
setShape
setShape([shape])
المعلّمات: 
قيمة العرض: بدون
اضبط شكل Marker المستخدَم للتفاعل. يمكنك الاطّلاع على MarkerOptions.shape وMarkerShape.
setTitle
setTitle([title])
المعلّمات: 
  • titlestring optional
قيمة العرض: بدون
أدخِل عنوان تلميح Marker. يمكنك الاطّلاع على MarkerOptions.title.
setVisible
setVisible(visible)
المعلّمات: 
  • visibleboolean إذا كانت true، تظهر أداة التحديد
قيمة العرض: بدون
اضبط ما إذا كان Marker مرئيًا.
setZIndex
setZIndex([zIndex])
المعلّمات: 
  • zIndexnumber optional
قيمة العرض: بدون
اضبط مؤشر z في Marker. يمكنك الاطّلاع على MarkerOptions.zIndex.
موروثة: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll
MAX_ZINDEX الحد الأقصى التلقائي لمؤشر z الذي ستخصّصه واجهة برمجة التطبيقات لعلامة. يمكنك ضبط فهرس z أعلى لجلب علامة إلى المقدمة.
animation_changed
function()
الوسيطات: بلا
يتم تنشيط هذا الحدث عند تغيير خاصية الرسوم المتحركة في Marker.
click
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند النقر على رمز Marker.
clickable_changed
function()
الوسيطات: بلا
يتم تنشيط هذا الحدث عند تغيير الخاصية Marker القابلة للنقر.
contextmenu
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث قائمة سياقات DOM على Marker.
cursor_changed
function()
الوسيطات: بلا
يتم تنشيط هذا الحدث عند تغيير خاصية المؤشر Marker.
dblclick
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند النقر مرتين على رمز Marker.
drag
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث بشكل متكرر أثناء سحب المستخدم Marker.
dragend
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عندما يتوقف المستخدم عن سحب Marker.
draggable_changed
function()
الوسيطات: بلا
يتم تنشيط هذا الحدث عند تغيير الخاصية Marker القابلة للسحب.
dragstart
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عندما يبدأ المستخدم في سحب Marker.
flat_changed
function()
الوسيطات: بلا
يتم تنشيط هذا الحدث عند تغيير الخاصية Marker الثابتة.
icon_changed
function()
الوسيطات: بلا
يتم تنشيط هذا الحدث عند تغيير خاصية الرمز Marker.
mousedown
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تمرير الماوس على Marker.
mouseout
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عندما يغادر الماوس رمز الرمز Marker.
mouseover
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عندما يدخل الماوس إلى منطقة الرمز Marker.
mouseup
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث للماوس الماوس في جهاز Marker.
position_changed
function()
الوسيطات: بلا
يتم تنشيط هذا الحدث عند تغيير خاصية الموضع Marker.
shape_changed
function()
الوسيطات: بلا
يتم تنشيط هذا الحدث عند تغيير خاصية الشكل Marker.
title_changed
function()
الوسيطات: بلا
يتم تنشيط هذا الحدث عند تغيير خاصية العنوان في Marker.
visible_changed
function()
الوسيطات: بلا
يتم تنشيط هذا الحدث عند تغيير الخاصية المرئية Marker.
zindex_changed
function()
الوسيطات: بلا
يتم تنشيط هذا الحدث عند تغيير خاصية Marker zIndex.
rightclick
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث للنقر بزر الماوس الأيمن على جهاز Marker.

واجهة MarkerOptions

واجهة google.maps.MarkerOptions

كائن BookOptions المُستخدَم لتحديد الخصائص التي يمكن ضبطها على أداة التحديد.

anchorPoint optional
النوع:  Point optional
إزاحة من موضع العلامة إلى طرف قاعدة InfoWindow التي تم فتحها مع العلامة كنقطة ارتساء.
animation optional
النوع:  Animation optional
الخيار التلقائي: null
الصور المتحركة التي يمكن تشغيلها عند إضافة محدِّد إلى خريطة
clickable optional
النوع:  boolean optional
الخيار التلقائي: true
إذا كانت true، ستتلقى العلامة أحداث ماوس ولمس.
BetacollisionBehavior optional
النوع:  string|CollisionBehavior optional
الخيار التلقائي: null
ضبط سلوك التصادم مع العلامات على خرائط المتّجه
crossOnDrag optional
النوع:  boolean optional
الخيار التلقائي: true
إذا كانت السياسة false، أوقِف ظهور كلمة المرور التي تظهر أسفل العلامة عند سحبها.
cursor optional
النوع:  string optional
الخيار التلقائي: pointer
نوع مؤشر الماوس للإظهار عند التمرير.
draggable optional
النوع:  boolean optional
الخيار التلقائي: false
إذا true، يمكن سحب محدّد الموقع.
icon optional
النوع:  string|Icon|Symbol optional
رمز للواجهة إذا تم توفير سلسلة، يتم التعامل معها على أنها Icon مع السلسلة url.
label optional
النوع:  string|MarkerLabel optional
الخيار التلقائي: null
إضافة تصنيف إلى العلامة. تصنيف العلامة هو حرف أو رقم يظهر داخل علامة. يمكن أن يكون التصنيف سلسلة أو عنصر MarkerLabel. إذا تم توفير العلامة مع توفير MarkerOptions.title، ستتم إضافة نص لتسهيل الاستخدام (مثل للاستخدام مع برامج قراءة الشاشة) إلى محدّد الموقع مع نص التصنيف المتوفّر. يُرجى العلم أنّ label لا يُستخدَم حاليًا إلا مع نص تسهيل الاستخدام للعلامات غير المحسّنة.
map optional
النوع:  Map|StreetViewPanorama optional
الخريطة التي سيتم عرض أداة التحديد عليها الخريطة مطلوبة لعرض محدّد الموقع ويمكن تقديمها مع Marker.setMap إذا لم يتم توفيرها عند إنشاء العلامة.
opacity optional
النوع:  number optional
تلقائي: 1.0
رقم بين 0.0 وشفاف و1.0، مبهم.
optimized optional
النوع:  boolean optional
يعمل التحسين على تحسين الأداء من خلال عرض العديد من العلامات كعنصر ثابت واحد. ويكون ذلك مفيدًا في الحالات التي يكون فيها عدد كبير من العلامات مطلوبًا. اطّلع على مزيد من المعلومات عن تحسين العلامات.
position optional
النوع:  LatLng|LatLngLiteral optional
لضبط موضع محدّد الموقع. يمكن أن يتم إنشاء محدِّد ولكن لا يتم عرضها إلى أن يتم تقديم موضعها، على سبيل المثال، من خلال إجراءات المستخدم أو خياراته. يمكن تقديم موضع علامة مع Marker.setPosition إذا لم يتم توفيرها عند إنشاء العلامة.
shape optional
النوع:  MarkerShape optional
تعريف منطقة خريطة الصورة المستخدمة للسحب/النقر.
title optional
النوع:  string optional
الخيار التلقائي: undefined
نص التمرير. ستتم إضافة نص لتسهيل الاستخدام (على سبيل المثال، للاستخدام مع برامج قراءة الشاشة) إلى العلامة مع القيمة المُقدَّمة. يُرجى العلم أنّ title لا يُستخدَم حاليًا إلا مع نص تسهيل الاستخدام للعلامات غير المحسّنة.
visible optional
النوع:  boolean optional
الخيار التلقائي: true
إذا كانت العلامة true، ستظهر العلامة.
zIndex optional
النوع:  number optional
يتم عرض جميع العلامات على الخريطة بترتيب الفهرس الخاص بها، مع عرض قيم أعلى أمام العلامات ذات القيم الأقل. وفقًا للإعدادات التلقائية، يتم عرض العلامات وفقًا لموضعها العمودي على الشاشة، مع ظهور علامات أدنى أمام العلامات فوق الشاشة.

ثوابت CollisionBehavior

google.maps.CollisionBehavior ثوابت

يمكنك الوصول من خلال الاتصال بـ const {CollisionBehavior} = await google.maps.importLibrary("marker"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

OPTIONAL_AND_HIDES_LOWER_PRIORITY لا تعرض العلامة إلا إذا كانت لا تتداخل مع علامات أخرى. إذا كان هناك علامتَان متداخلتَين من هذا النوع، سيتم عرض الرقم الذي يحمل علامة zIndex الأعلى. إذا كان لديه نفس zIndex، سيتم عرض الموضع الذي يتميز بموضع الشاشة الرأسي السفلي.
REQUIRED عرض العلامة دائمًا بغض النظر عن التصادم. وهذا هو الخيار التلقائي.
REQUIRED_AND_HIDES_OPTIONAL عرض العلامة دائمًا بصرف النظر عن التصادم، وإخفاء أي علامات OPTIONAL_AND_HIDES_LOWER_PRIORITY أو التصنيفات التي قد تتداخل مع العلامة.

واجهة الرمز

واجهة google.maps.Icon

بنية تمثّل صورة رمز "أداة تحديد العلامات"

url
النوع:  string
عنوان URL للصورة أو ورقة الصور المتحركة.
anchor optional
النوع:  Point optional
الموضع الذي يتم فيه تثبيت صورة بالنسبة إلى موقع محدّد الموقع على الخريطة. يتم تلقائيًا وضع علامة الارتساء على طول النقطة المركزية في أسفل الصورة.
labelOrigin optional
النوع:  Point optional
أصل التصنيف المرتبط أعلى يمين صورة الرمز، إذا تم توفير تصنيفًا بواسطة العلامة. ويظهر المصدر بشكل تلقائي في النقطة المركزية من الصورة.
origin optional
النوع:  Point optional
موضع الصورة داخل الصورة، إن توفّرت. يظهر مصدر الصورة تلقائيًا في أعلى يمين الصورة (0, 0).
scaledSize optional
النوع:  Size optional
حجم الصورة بأكملها بعد تغيير الحجم، إن وجد. يمكنك استخدام هذه السمة لتمديد أو تصغير الصورة أو الصورة المتحركة.
size optional
النوع:  Size optional
حجم عرض الصورة المتحركة أو الصورة. عند استخدام الصور المضغوطة، يجب تحديد حجم الصور المضغوطة. إذا لم يتم توفير المقاس، سيتم ضبطه عند تحميل الصورة.

واجهة MarkerLabel

واجهة google.maps.MarkerLabel

تحدد هذه الخيارات مظهر تصنيف العلامة. تصنيف العلامة هو سلسلة (غالبًا ما تكون حرفًا واحدًا) سيظهر داخل العلامة. إذا كنت تستخدمها مع علامة مخصّصة، يمكنك إعادة وضعها مع السمة labelOrigin في الفئة Icon.

text
النوع:  string
النص الذي سيتم عرضه في التصنيف.
className optional
النوع:  string optional
تلقائي: '' (سلسلة فارغة)
سمة className لعنصر التصنيف (ما يعادل سمة فئة العنصر) يمكن إضافة عدة فئات CSS مفصولة بمسافات. لا يمكن ضبط لون الخط وحجمه ووزنه وعائلته إلا من خلال خصائص MarkerLabel الأخرى. يجب عدم استخدام فئات CSS لتغيير موضع التصنيف أو اتجاهه (على سبيل المثال، استخدام الترجمات والتدوير) إذا كانت هذه الصور تستخدم أيضًا إدارة تعارض العلامات.
color optional
النوع:  string optional
الخيار التلقائي: 'black'
لون نص التصنيف.
fontFamily optional
النوع:  string optional
مجموعة الخطوط لنص التصنيف (ما يعادل خاصية مجموعة خطوط CSS).
fontSize optional
النوع:  string optional
الخيار التلقائي: '14px'
حجم خط نص التصنيف (ما يعادل خاصية خط CSS).
fontWeight optional
النوع:  string optional
كثافة خط نص التصنيف (ما يعادل خاصية خط CSS)

واجهة Marker

واجهة google.maps.MarkerShape

يحدد هذا العنصر المنطقة التي يمكن النقر عليها في صورة علامة. يتكون الشكل من سمتَين: type وcoord، وهما يحددان المنطقة غير الشفافة للصور.

coords
النوع:  Array<number>
يعتمد تنسيق هذه السمة على قيمة type ويتّبع مواصفات السمة w3 (coords) الواردة على الرابط http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords.
السمة coords هي مصفوفة من الأعداد الصحيحة التي تحدّد موضع وحدة البكسل للشكل بالنسبة إلى أعلى يسار الصورة المستهدفة. تعتمد الإحداثيات على قيمة type كما يلي:
- circle: الأقواس هي [x1,y1,r] حيث يكون x1,y2 إحداثيات وسط الدائرة وr هو نصف الدائرة.
- poly: الأقواس هي [x1,y1,x2,y2...xn,yn] حيث يحتوي كل زوج x,y على إحداثيات رأس واحد من المضلع.
- rect: الأقواس هي [x1,y1,x2,y2] حيث يكون x1,y1 إحداثيات الزاوية العلوية اليسرى للمستطيل وx2,y2 هي إحداثيات الإحداثيات السفلية اليمنى للمستطيل.
type
النوع:  string
تصف نوع الشكل ويمكن أن تكون circle أو poly أو rect.

واجهة رمز

واجهة google.maps.Symbol

وصف الرمز الذي يتكون من مسار متّجه بالنمط. يمكن استخدام الرمز كرمز لمحدّد موقع، أو وضعه على شكل خط متعدد.

path
النوع:  SymbolPath|string
مسار الرمز، وهو مسار رمز مدمج، أو مسار مخصّص يتم التعبير عنه باستخدام تدوين مسار SVG. مطلوبة.
anchor optional
النوع:  Point optional
الخيار التلقائي: google.maps.Point(0,0)
موضع الرمز بالنسبة إلى العلامة أو الخط المتعدد. تتم ترجمة إحداثيات مسار الرمز إلى أعلى وإلى أعلى من خلال إحداثيات x وy لعلامة الارتساء على التوالي. يتم التعبير عن الموضع في نظام الإحداثيات نفسه كمسار الرمز.
fillColor optional
النوع:  string optional
لون تعبئة الرمز. وتتوفّر جميع ألوان CSS3 باستثناء الألوان ذات الأسماء الموسّعة. وبالنسبة إلى علامات الرموز، يتم ضبط الإعداد التلقائي على "أسود". بالنسبة إلى الرموز في الخطوط المتعددة، يكون هذا الإعداد التلقائي هو لون خط السكة الحديدية للخط المستقيم.
fillOpacity optional
النوع:  number optional
الخيار التلقائي: 0
تعتيم ملء الرمز.
labelOrigin optional
النوع:  Point optional
الخيار التلقائي: google.maps.Point(0,0)
أصل التصنيف بالنسبة إلى أصل المسار، إذا تم توفير العلامة بواسطة العلامة. ويتم التعبير عن المصدر في نظام الإحداثيات نفسه كمسار الرمز. هذه السمة غير مستخدَمة للرموز على الخطوط المتعددة.
rotation optional
النوع:  number optional
الخيار التلقائي: 0
الزاوية التي يتم من خلالها تدوير الرمز، ويتم التعبير عنها في اتجاه عقارب الساعة. رمز في IconSequence حيث يتم تدوير fixedRotation false، بالنسبة إلى زاوية الحافة التي تقع عليه.
scale optional
النوع:  number optional
مقدار تغيير حجم الرمز. بالنسبة إلى علامات الرموز، يكون الإعداد التلقائي هو 1، وقد يكون الرمز بعد تغيير الحجم بأيّ حجم. بالنسبة إلى الرموز على الخط المضلع، يشير هذا إلى ضبط كثافة خط الخطوط المتعددة. وبعد تغيير الحجم، يجب أن يقع الرمز داخل مربع 22 بكسل بحجم توسيط في نقطة ارتساء الرمز.
strokeColor optional
النوع:  string optional
لون ضربة الرمز وتتوفّر جميع ألوان CSS3 باستثناء الألوان ذات الأسماء الموسّعة. وبالنسبة إلى علامات الرموز، يتم ضبط الإعداد التلقائي على "أسود". بالنسبة إلى الرموز على الخط المضلّع، يكون هذا الإعداد التلقائي هو لون خط السكة الحديدية.
strokeOpacity optional
النوع:  number optional
تعتيم ضربة الرمز. بالنسبة إلى علامات الرموز، يكون الإعداد التلقائي هو 1. بالنسبة إلى الرموز في الخط المضلع، يكون الإعداد التلقائي هو تعتيم خط السكة الحديدية.
strokeWeight optional
النوع:  number optional
القيمة التلقائية: تمثّل هذه السمة Symbol.scale الرمز.
كثافة خط الرمز.

ثوابت SymbolPath

google.maps.SymbolPath ثوابت

مسارات الرموز المدمجة

يمكنك الوصول من خلال الاتصال بـ const {SymbolPath} = await google.maps.importLibrary("core"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

BACKWARD_CLOSED_ARROW سهم مغلق يشير إلى الخلف.
BACKWARD_OPEN_ARROW سهم مفتوح يشير إلى الخلف.
CIRCLE دائرة.
FORWARD_CLOSED_ARROW سهم مغلق يشير إلى الأمام.
FORWARD_OPEN_ARROW سهم مفتوح يشير إلى الأمام.

ثوابت الصور المتحركة

google.maps.Animation ثوابت

الصور المتحركة التي يمكن تشغيلها على محدِّد موقع استخدِم الإجراء Marker.setAnimation على أداة التحديد أو الخيار MarkerOptions.animation لتشغيل صورة متحركة.

يمكنك الوصول من خلال الاتصال بـ const {Animation} = await google.maps.importLibrary("marker"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

BOUNCE ترتد العلامة إلى أن تتوقف الصورة المتحركة من خلال طلب Marker.setAnimation مع null.
DROP يسقط محدّد الموقع من أعلى الخريطة إلى موقعه النهائي. ستتوقف الصورة المتحركة بعد تراجع العلامة، وسيعرض تطبيق Marker.getAnimation القيمةnull. يتم عادةً تحديد هذا النوع من الصور المتحركة أثناء إنشاء محدّد الموقع.