فئة Marker
صف واحد (google.maps.Marker
)
تمتد هذه الفئة إلى
MVCObject
.
يمكنك الوصول من خلال الاتصال على الرقم const {Marker} = await google.maps.importLibrary("marker")
. يمكنك الاطّلاع على المكتبات في Maps JavaScript API.
الشركة المصنِّعة | |
---|---|
Marker |
Marker([opts]) المَعلمات:
لإنشاء علامة بالخيارات المحددة. إذا تم تحديد خريطة، تتم إضافة العلامة إلى الخريطة عند البناء. لاحظ أنه يجب تعيين الموضع حتى يتم عرض العلامة. |
الثوابت | |
---|---|
MAX_ZINDEX |
الحد الأقصى لفهرس z التلقائي الذي ستعيّنه واجهة برمجة التطبيقات لعلامة ما. يمكنك تعيين مؤشر z أعلى لإظهار علامة في المقدمة. |
الطُرق | |
---|---|
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) الوسيطات:
يتم تنشيط هذا الحدث عند تنشيط حدث واجهة برمجة التطبيقات Document Menu على 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() الوسيطات: لا شيء
يتم تنشيط هذا الحدث عند تغيير سمة zIndex Marker . |
|
function(event) الوسيطات:
يتم تنشيط هذا الحدث بنقرة بزر الماوس الأيمن على Marker . |
واجهة MarkerOptions
واجهة google.maps.MarkerOptions
كائن 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 ، ستتم إضافة نص تسهيل الاستخدام (على سبيل المثال للاستخدام مع برامج قراءة الشاشة) إلى العلامة مع نص التصنيف المقدّم. تجدر الإشارة إلى أنّ السمة 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")
. يمكنك الاطّلاع على المكتبات في Maps JavaScript API.
الثوابت | |
---|---|
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). |
fontSize optional |
النوع:
string optional الخيار التلقائي:
'14px' حجم خط نص التصنيف (ما يعادل خاصية حجم الخط في CSS). |
fontWeight optional |
النوع:
string optional عرض خط نص التصنيف (ما يعادل خاصية وزن الخط في CSS). |
واجهة MarkerShape
واجهة google.maps.MarkerShape
يحدد هذا الكائن المنطقة القابلة للنقر لصورة العلامة. يتكون الشكل من خاصيتين — type
وcoord
— تحددان المنطقة غير الشفافة للصورة.
أماكن إقامة | |
---|---|
coords |
النوع:
Array<number> يعتمد تنسيق هذه السمة على قيمة type ويتّبع مواصفات coords لمنطقة w3 المتوفّرة على الرابط 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 . |
واجهة Symbol
واجهة 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")
. يمكنك الاطّلاع على المكتبات في Maps JavaScript API.
الثوابت | |
---|---|
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")
. يمكنك الاطّلاع على المكتبات في Maps JavaScript API.
الثوابت | |
---|---|
BOUNCE |
ترتد العلامة إلى أن تتوقف الرسوم المتحركة عن طريق استدعاء Marker.setAnimation باستخدام null . |
DROP |
تسقط العلامة من أعلى الخريطة إلى موقعها النهائي. سيتم إيقاف الصورة المتحركة عند توقف العلامة عن العمل، وسيعرض Marker.getAnimation الرمز null . عادةً ما يتم تحديد هذا النوع من الرسوم المتحركة أثناء إنشاء العلامة. |