Marker

فئة تمييز

google.maps.Marker الصف الدراسي

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

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

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|null|Symbol|undefined
احصل على رمز Marker. يمكنك الاطّلاع على MarkerOptions.icon.
getLabel
getLabel()
المعلّمات: بدون
قيمة الإرجاع:  MarkerLabel|null|string|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 zIndex للعلامة.
احصل على فهرس 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

أداة الخيارات المتاحة لتحديد الخصائص التي يمكن تعيينها على العلامة.

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
يتم عرض جميع العلامات على الخريطة بترتيب zIndex، مع عرض قيم أعلى أمام العلامات ذات القيم المنخفضة. بشكل افتراضي، يتم عرض العلامات بناءً على موضعها الرأسي على الشاشة، مع ظهور العلامات الأقل أمام العلامات أعلى الشاشة.

ثوابت CollisionBehavior

google.maps.CollisionBehavior ثوابت

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

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

Icon واجهة

واجهة 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 font-family).
fontSize optional
النوع:  string optional
تلقائي: '14px'
حجم خط نص التصنيف (يعادل خاصية حجم خط CSS).
fontWeight optional
النوع:  string optional
وزن خط نص التصنيف (يعادل خاصية كثافة الخط في CSS).

واجهة MarkerShape

واجهة google.maps.MarkerShape

يحدد هذا الكائن المنطقة القابلة للنقر لصورة العلامة. يتكون الشكل من خاصيتين — type وcoord — تحددان المنطقة غير الشفافة في الصورة.

coords
النوع:  Array<number>
يعتمد تنسيق هذه السمة على قيمة type ويتبع مواصفات w3 AREA 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)
موضع الرمز بالنسبة إلى العلامة أو الخطوط المتعددة. تتم ترجمة إحداثيات مسار الرمز لليسار ولأعلى بواسطة إحداثي "س" و"ص" على التوالي. يتم التعبير عن الموضع في نفس نظام إحداثيات مسار الرمز.
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"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

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"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

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