فئة محدِّد الموقع
google.maps.Marker
class
يمتدّ هذا الصف إلى
MVCObject
.
يمكنك الوصول إليه من خلال الاتصال بالرقم const {Marker} = await google.maps.importLibrary("marker")
. اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
الشركة المصنِّعة | |
---|---|
Marker |
Marker([opts]) المَعلمات:
تنشئ علامة باستخدام الخيارات المحدّدة. في حال تحديد خريطة، تتم إضافة العلامة إلى الخريطة عند إنشاء العنصر. يُرجى العِلم أنّه يجب ضبط الموضع لكي تظهر العلامة. |
الثوابت | |
---|---|
MAX_ZINDEX |
الحد الأقصى للمؤشر التلقائي للمستوى z الذي ستحدّده واجهة برمجة التطبيقات للعلامة يمكنك ضبط قيمة أعلى لسمة z-index لعرض علامة في المقدّمة. |
الطُرق | |
---|---|
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|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 |
getTitle |
getTitle() المَعلمات: بدون
القيمة المعروضة:
string|null|undefined الحصول على عنوان التلميح Marker يمكنك الاطّلاع على MarkerOptions.title . |
getVisible |
getVisible() المَعلمات: بدون
القيمة المعروضة:
boolean صحيح إذا كان العلامة مرئيًا.الحصول على إذن الوصول إلى Marker |
getZIndex |
getZIndex() المَعلمات: بدون
القيمة المعروضة:
number|null|undefined zIndex للعلامة.احصل على zIndex للعنصر 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]) المَعلمات:
القيمة المعروضة: لا شيء
اضبط zIndex للعنصر Marker . يمكنك الاطّلاع على MarkerOptions.zIndex . |
مُكتسَبة:
addListener ،
bindTo ،
get ،
notify ،
set ،
setValues ،
unbind ،
unbindAll
|
الفعاليات | |
---|---|
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 flat property. |
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 visible. |
zindex_changed |
function() الوسيطات: بدون
يتم تنشيط هذا الحدث عند تغيير سمة Marker zIndex. |
|
function(event) الوسيطات:
يتم تنشيط هذا الحدث عند النقر بزر الماوس الأيمن على Marker . |
MarkerOptions
google.maps.MarkerOptions
واجهة
عنصر 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 وعدم توفّر 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")
. اطّلِع على المكتبات في واجهة برمجة تطبيقات 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 لعنصر التصنيف (مكافئة لسمة class للعنصر) يمكن إضافة عدة فئات CSS مفصولة بمسافات. لا يمكن ضبط لون الخط وحجمه وسُمكه وعائلته إلا من خلال السمات الأخرى MarkerLabel . يجب عدم استخدام فئات CSS لتغيير موضع التصنيف أو اتجاهه (مثلاً باستخدام عمليات الترجمة والدوران) في حال استخدام إدارة تداخل العلامات أيضًا. |
color optional |
النوع:
string optional القيمة التلقائية:
'black' لون نص التصنيف |
fontFamily optional |
النوع:
string optional مجموعة خطوط نص التصنيف (مكافئة لخاصيّة font-family في CSS) |
fontSize optional |
النوع:
string optional القيمة التلقائية:
'14px' حجم خط نص التصنيف (ما يعادل خاصية font-size في CSS) |
fontWeight optional |
النوع:
string optional سمك خط نص التصنيف (ما يعادل خاصية font-weight في 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 : coords هي [x1,y1,r] حيث x1 وy2 هما إحداثيات مركز الدائرة، وr هو نصف قطر الدائرة. - poly : coords هي [x1,y1,x2,y2...xn,yn] حيث يحتوي كل زوج من x وy على إحداثيات رأس واحد من المضلّع. - rect : coords هي [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 constants
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 . يتم تحديد هذا النوع من الصور المتحركة عادةً أثناء إنشاء العلامة. |