فئة المُحدِّد
صف واحد (google.maps.Marker
)
يمتد هذا الصف
MVCObject
.
يمكنك الوصول من خلال الاتصال بـ const {Marker} = await google.maps.importLibrary("marker")
. اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
الشركة المصنِّعة | |
---|---|
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 zفهرس أداة التحديد.عليك الحصول على فهرس 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
كائن BookOptions المُستخدَم لتحديد الخصائص التي يمكن ضبطها على أداة التحديد.
أماكن إقامة | |
---|---|
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 يتم عرض جميع العلامات على الخريطة بترتيب الفهرس الخاص بها، مع عرض قيم أعلى أمام العلامات ذات القيم الأقل. وفقًا للإعدادات التلقائية، يتم عرض العلامات وفقًا لموضعها العمودي على الشاشة، مع ظهور علامات أدنى أمام العلامات فوق الشاشة. |
ثوابت 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 . يتم عادةً تحديد هذا النوع من الصور المتحركة أثناء إنشاء محدّد الموقع. |