فئة تمييز
google.maps.Marker
الصف الدراسي
يمتد هذا الصف
MVCObject
.
الوصول من خلال الاتصال بـ const {Marker} = await google.maps.importLibrary("marker")
. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
الشركة المصنِّعة | |
---|---|
Marker |
Marker([opts]) المعلّمات:
لإنشاء علامة تحديد الخيارات المحددة. في حالة تحديد خريطة، تتم إضافة العلامة إلى الخريطة عند الإنشاء. لاحظ أنه يجب تعيين الموضع ليتم عرض العلامة. |
الطُرق | |
---|---|
getAnimation |
getAnimation() المعلّمات: بدون
قيمة الإرجاع:
Animation|null|undefined الحصول على الصورة المتحركة قيد التشغيل حاليًا. |
getClickable |
getClickable() المعلّمات: بدون
قيمة العرض:
boolean تكون القيمة صحيحة إذا كانت العلامة قابلة للنقر.يمكنك الاطّلاع على حالة Marker القابلة للنقر. |
getCursor |
getCursor() المعلّمات: بدون
قيمة الإرجاع:
string|null|undefined عرض نوع مؤشر الماوس عند التمرير |
getDraggable |
getDraggable() المعلّمات: بدون
قيمة العرض:
boolean تكون القيمة صحيحة إذا كانت العلامة قابلة للسحب.احصل على الحالة القابلة للسحب في Marker . |
getIcon |
getIcon() المعلّمات: بدون
احصل على رمز 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 |
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]) المعلّمات:
قيمة الإرجاع: بدون
ابدأ الصورة المتحركة. سيتم إلغاء أي صورة متحركة جارية. الصور المتحركة المعتمدة حاليًا هي: Animation.BOUNCE وAnimation.DROP . سيؤدي المرور داخل null إلى إيقاف أي رسوم متحركة. |
setClickable |
setClickable(flag) المعلّمات:
قيمة الإرجاع: بدون
اضبط ما إذا كان Marker قابلاً للنقر. |
setCursor |
setCursor([cursor]) المعلّمات:
قيمة الإرجاع: بدون
ضبط نوع مؤشر الماوس الظاهر عند التمرير |
setDraggable |
setDraggable(flag) المعلّمات:
قيمة الإرجاع: بدون
يمكنك ضبط ما إذا كان Marker قابلاً للسحب. |
setIcon |
setIcon([icon]) قيمة الإرجاع: بدون
تعيين رمز Marker . يمكنك الاطّلاع على MarkerOptions.icon . |
setLabel |
setLabel([label]) المعلّمات:
قيمة الإرجاع: بدون
حدِّد تصنيف Marker . يمكنك الاطّلاع على MarkerOptions.label . |
setMap |
setMap(map) المعلّمات:
قيمة الإرجاع: بدون
لعرض Marker على الخريطة أو الصورة البانورامية المحددة. في حال ضبط الخريطة على null ، ستتم إزالة محدّد الموقع. |
setOpacity |
setOpacity([opacity]) المعلّمات:
قيمة الإرجاع: بدون
ضبط تعتيم Marker . |
setOptions |
setOptions(options) المعلّمات:
قيمة الإرجاع: بدون
حدِّد خيارات Marker . |
setPosition |
setPosition([latlng]) المعلّمات:
قيمة الإرجاع: بدون
تعيين التدوين لـ Marker . |
setShape |
setShape([shape]) المعلّمات:
قيمة الإرجاع: بدون
|
setTitle |
setTitle([title]) المعلّمات:
قيمة الإرجاع: بدون
اضبط عنوان التلميح Marker . يمكنك الاطّلاع على MarkerOptions.title . |
setVisible |
setVisible(visible) المعلّمات:
قيمة الإرجاع: بدون
يمكنك تحديد ما إذا كان Marker مرئيًا أم لا. |
setZIndex |
setZIndex([zIndex]) المعلّمات:
قيمة الإرجاع: بدون
اضبط مؤشر 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. |
|
function(event) الوسيطات:
تم تنشيط هذا الحدث عند النقر بزر الماوس الأيمن على Marker . |
MarkerOptions واجهة
واجهة
google.maps.MarkerOptions
أداة الخيارات المتاحة لتحديد الخصائص التي يمكن تعيينها على العلامة.
أماكن إقامة | |
---|---|
anchorPoint optional |
النوع:
Point optional الإزاحة من موضع العلامة إلى رأس نافذة InfoWindow التي تم فتحها مع وضع العلامة كارتساء. |
animation optional |
النوع:
Animation optional تلقائي:
null الصورة المتحركة التي يتم تشغيلها عند إضافة محدّد موقع إلى خريطة. |
clickable optional |
النوع:
boolean optional تلقائي:
true إذا كان true ، تتلقى العلامة أحداث الماوس واللمس. |
|
النوع:
string|CollisionBehavior optional تلقائي:
null تعيين سلوك التصادم للعلامات على الخرائط المتجهة. |
crossOnDrag optional |
النوع:
boolean optional تلقائي:
true إذا كان false ، يوقِف علامة الصليب التي تظهر أسفل العلامة عند السحب. |
cursor optional |
النوع:
string optional تلقائي:
pointer حرك مؤشر الماوس لعرضه عند التمرير. |
draggable optional |
النوع:
boolean optional تلقائي:
false إذا كانت true ، فيمكن سحب العلامة. |
icon 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 . عادة ما يتم تحديد هذا النوع من الحركة أثناء إنشاء العلامة. |