Marker

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

فئة ماركر

google.maps.Marker الصف

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

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 z مؤشر العلامة.
احصل على فهرس z للمؤشر Marker. يمكنك الاطّلاع على MarkerOptions.zIndex.
setAnimation
setAnimation([animation])
المعلّمات:
  • animation: Animation optional الصورة المتحركة لتشغيلها
قيمة العرض: لا شيء
ابدأ صورة متحركة. سيتم إلغاء أي صورة متحركة جارية. الصور المتحركة المتوافقة حاليًا هي: Animation.BOUNCE وAnimation.DROP. سيؤدي تمرير null إلى إيقاف أي صورة متحركة.
setClickable
setClickable(flag)
المعلّمات:
  • flag: boolean إذا true، يمكن النقر على العلامة.
قيمة العرض: لا شيء
اضبط ما إذا كان Marker قابلاً للنقر عليه.
setCursor
setCursor([cursor])
المعلّمات:
  • cursor: string 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])
المعلّمات:
  • opacity: number optional رقم يتراوح بين 0.0 وشفاف و1.0، معتم
قيمة العرض: لا شيء
اضبط تعتيم Marker.
setOptions
setOptions(options)
المعلّمات:
قيمة العرض: لا شيء
حدِّد خيارات Marker.
setPosition
setPosition([latlng])
المعلّمات:
قيمة العرض: لا شيء
اضبط إعدادات Marker.
setShape
setShape([shape])
المعلّمات:
قيمة العرض: لا شيء
ضبط شكل Marker المستخدم للتفاعل. يمكنك الاطّلاع على MarkerOptions.shape وMarkerShape.
setTitle
setTitle([title])
المعلّمات:
  • title: string optional
قيمة العرض: لا شيء
حدِّد عنوان التلميح Marker. يمكنك الاطّلاع على MarkerOptions.title.
setVisible
setVisible(visible)
المعلّمات:
  • visibleboolean إذا true، ستكون العلامة مرئية
قيمة العرض: لا شيء
يمكنك ضبط هذه السياسة إذا كان Marker مرئيًا.
setZIndex
setZIndex([zIndex])
المعلّمات:
  • zIndex: number 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
يتم عرض جميع العلامات على الخريطة بترتيب z، مع عرض قيم أعلى أمام العلامات ذات القيم المنخفضة. يتم تلقائيًا عرض العلامات حسب موضعها الرأسي على الشاشة، مع ظهور علامات أدنى أمام العلامات في أعلى الشاشة.

ثوابت مجتمعية ثوابت

google.maps.CollisionBehavior ثوابت

OPTIONAL_AND_HIDES_LOWER_PRIORITY عدم عرض العلامة إلا إذا كانت لا تتداخل مع علامات أخرى. إذا تداخل علامتان من هذا النوع، يتم عرض العلامة التي لها مؤشر z الأعلى. وإذا كان لهما 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 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)
موضع الرمز بالنسبة إلى العلامة أو الخط المتعدد. تتم ترجمة إحداثيات مسار الرمز لليسار ولأعلى بإحداثي الارتساء 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 ثوابت

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

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

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

google.maps.Animation ثوابت

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

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