حزمة أدوات Places UI Kit: هي مكتبة جاهزة للاستخدام تتيح للمطوّرين إمكانية التخصيص والتحكّم. ننصحك بتجربتها ومشاركة ملاحظاتك حول تجربتك مع حزمة واجهة المستخدم.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Marker (legacy)

فئة Marker

google.maps.Marker صف

تم إيقافها نهائيًا: اعتبارًا من 21 شباط (فبراير) 2024، تم إيقاف google.maps.Marker نهائيًا. يُرجى استخدام AdvancedMarkerElement بدلاً من ذلك. في الوقت الحالي، ليس من المقرر إيقاف google.maps.Marker نهائيًا، ولكن يُنصح باستخدام AdvancedMarkerElement بدلاً من google.maps.Marker. مع أنّ google.maps.Marker سيستمر في تلقّي إصلاحات الأخطاء لأي تراجع كبير، لن يتم إصلاح الأخطاء الحالية في google.maps.Marker. سيتم إرسال إشعار قبل 12 شهرًا على الأقل من إيقاف الدعم. يُرجى الاطّلاع على https://developers.google.com/maps/deprecations للحصول على تفاصيل إضافية وعلى https://developers.google.com/maps/documentation/javascript/advanced-markers/migration للاطّلاع على دليل نقل البيانات.

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Marker} = await google.maps.importLibrary("marker").
اطّلِع على المكتبات في Maps JavaScript API.

الشركة المصنِّعة
`Marker`	`Marker([opts])` المَعلمات: `opts`: `MarkerOptions optional` وسيطات اختيارية مسماة تنشئ هذه الطريقة علامة باستخدام الخيارات المحدّدة. في حال تحديد خريطة، تتم إضافة العلامة إليها عند إنشائها. يُرجى العِلم أنّه يجب ضبط الموضع لكي يظهر محدّد الموقع.

الشركة المصنِّعة

Marker

Marker([opts])

المَعلمات:

opts: MarkerOptions optional وسيطات اختيارية مسماة

تنشئ هذه الطريقة علامة باستخدام الخيارات المحدّدة. في حال تحديد خريطة، تتم إضافة العلامة إليها عند إنشائها. يُرجى العِلم أنّه يجب ضبط الموضع لكي يظهر محدّد الموقع.

الثوابت
`MAX_ZINDEX`	الحد الأقصى التلقائي لمؤشر z الذي ستحدّده واجهة برمجة التطبيقات لعلامة. يمكنك ضبط قيمة أعلى لفهرس z لجلب علامة إلى المقدّمة.

الطُرق
`getAnimation`	`getAnimation()` المَعلمات: بدون قيمة العائد: `Animation\|null\|undefined` الحصول على الصورة المتحركة التي يتم تشغيلها حاليًا
`getClickable`	`getClickable()` المَعلمات: بدون قيمة العرض: `boolean` تعرض هذه السمة القيمة True إذا كان يمكن النقر على العلامة. احصل على حالة النقر على `Marker`.
`getCursor`	`getCursor()` المَعلمات: بدون قيمة العائد: `string\|null\|undefined` الحصول على نوع مؤشر الماوس المعروض عند التمرير
`getDraggable`	`getDraggable()` المَعلمات: بدون قيمة العرض: `boolean` تعرض القيمة True إذا كان يمكن سحب العلامة. الحصول على حالة السحب والإفلات الخاصة بـ `Marker`
`getIcon`	`getIcon()` المَعلمات: بدون قيمة العائد: `string\|Icon\|Symbol\|null\|undefined` الحصول على رمز `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` تعرض هذه السمة شكل `Marker` المستخدَم للتفاعل. يمكنك الاطّلاع على `MarkerOptions.shape` و`MarkerShape`.
`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`: `Animation optional` الصورة المتحركة التي سيتم تشغيلها القيمة المعروضة: لا شيء بدء صورة متحركة سيتم إلغاء أي رسوم متحركة قيد التشغيل. الصور المتحركة المتوافقة حاليًا هي: `Animation.BOUNCE` و`Animation.DROP`. سيؤدي إدخال `null` إلى إيقاف أي صورة متحركة.
`setClickable`	`setClickable(flag)` المَعلمات: `flag`: `boolean` إذا كانت القيمة `true`، يمكن النقر على العلامة. القيمة المعروضة: لا شيء تحديد ما إذا كان `Marker` قابلاً للنقر
`setCursor`	`setCursor([cursor])` المَعلمات: `cursor`: `string optional` نوع مؤشر الماوس القيمة المعروضة: لا شيء ضبط نوع مؤشر الماوس الذي يظهر عند التمرير
`setDraggable`	`setDraggable(flag)` المَعلمات: `flag`: `boolean optional` إذا كانت القيمة `true`، يمكن سحب العلامة. القيمة المعروضة: لا شيء تُستخدَم لتحديد ما إذا كان يمكن سحب `Marker`.
`setIcon`	`setIcon([icon])` المَعلمات: `icon`: `string\|Icon\|Symbol optional` القيمة المعروضة: لا شيء اضبط رمز `Marker`. يمكنك الاطّلاع على `MarkerOptions.icon`.
`setLabel`	`setLabel([label])` المَعلمات: `label`: `string\|MarkerLabel optional` يمكن أن يكون التصنيف سلسلة أحرف أو كائن `MarkerLabel`. القيمة المعروضة: لا شيء اضبط تصنيف `Marker`. يمكنك الاطّلاع على `MarkerOptions.label`.
`setMap`	`setMap(map)` المَعلمات: `map`: `Map\|StreetViewPanorama` القيمة المعروضة: لا شيء تعرض هذه السمة `Marker` على الخريطة أو الصورة البانورامية المحدّدة. إذا تم ضبط الخريطة على `null`، ستتم إزالة العلامة.
`setOpacity`	`setOpacity([opacity])` المَعلمات: `opacity`: `number optional` رقم يتراوح بين 0.0 (شفاف) و1.0 (معتم). القيمة المعروضة: لا شيء اضبط مستوى تعتيم `Marker`.
`setOptions`	`setOptions(options)` المَعلمات: `options`: `MarkerOptions` القيمة المعروضة: لا شيء اضبط خيارات `Marker`.
`setPosition`	`setPosition([latlng])` المَعلمات: `latlng`: `LatLng\|LatLngLiteral optional` الموضع الجديد القيمة المعروضة: لا شيء اضبط موضع `Marker`.
`setShape`	`setShape([shape])` المَعلمات: `shape`: `MarkerShape optional` القيمة المعروضة: لا شيء اضبط شكل `Marker` المستخدَم للتفاعل. يمكنك الاطّلاع على `MarkerOptions.shape` و`MarkerShape`.
`setTitle`	`setTitle([title])` المَعلمات: `title`: `string optional` القيمة المعروضة: لا شيء اضبط عنوان تلميح الأداة `Marker`. يمكنك الاطّلاع على `MarkerOptions.title`.
`setVisible`	`setVisible(visible)` المَعلمات: `visible`: `boolean` إذا كانت القيمة `true`، يكون العلامة مرئية القيمة المعروضة: لا شيء تحديد ما إذا كان `Marker` مرئيًا
`setZIndex`	`setZIndex([zIndex])` المَعلمات: `zIndex`: `number optional` القيمة المعروضة: لا شيء اضبط قيمة zIndex الخاصة بـ `Marker`. يمكنك الاطّلاع على `MarkerOptions.zIndex`.
موروثة: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

الفعاليات
`animation_changed`	`function()` الوسيطات: لا شيء يتم إطلاق هذا الحدث عند تغيير سمة الحركة `Marker`.
`click`	`function(event)` الوسيطات: `event`: `MapMouseEvent` يتم إطلاق هذا الحدث عند النقر على الرمز `Marker`.
`clickable_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيُّر السمة `Marker` القابلة للنقر.
`contextmenu`	`function(event)` الوسيطات: `event`: `MapMouseEvent` يتم تنشيط هذا الحدث عند تنشيط حدث قائمة السياق في نموذج المستند (DOM) على `Marker`
`cursor_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير `Marker` سمة المؤشر.
`dblclick`	`function(event)` الوسيطات: `event`: `MapMouseEvent` يتم إطلاق هذا الحدث عند النقر مرّتين على الرمز `Marker`.
`drag`	`function(event)` الوسيطات: `event`: `MapMouseEvent` يتم تنشيط هذا الحدث بشكل متكرّر أثناء سحب المستخدم `Marker`.
`dragend`	`function(event)` الوسيطات: `event`: `MapMouseEvent` يتم تنشيط هذا الحدث عندما يتوقف المستخدم عن سحب `Marker`.
`draggable_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير السمة `Marker` draggable.
`dragstart`	`function(event)` الوسيطات: `event`: `MapMouseEvent` يتمّ تشغيل هذا الحدث عندما يبدأ المستخدم في سحب `Marker`.
`flat_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيُّر السمة `Marker` flat.
`icon_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير سمة الرمز `Marker`.
`mousedown`	`function(event)` الوسيطات: `event`: `MapMouseEvent` يتم تنشيط هذا الحدث عند النقر بالزر الأيسر للفأرة على `Marker`.
`mouseout`	`function(event)` الوسيطات: `event`: `MapMouseEvent` يتم إطلاق هذا الحدث عندما يغادر مؤشر الماوس منطقة الرمز `Marker`.
`mouseover`	`function(event)` الوسيطات: `event`: `MapMouseEvent` يتم إطلاق هذا الحدث عندما يدخل مؤشر الماوس إلى مساحة الرمز `Marker`.
`mouseup`	`function(event)` الوسيطات: `event`: `MapMouseEvent` يتم تنشيط هذا الحدث عند تحرير زر الماوس على `Marker`.
`position_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير السمة `Marker` الخاصة بالموضع.
`shape_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير سمة الشكل `Marker`.
`title_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير `Marker` سمة العنوان.
`visible_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيُّر السمة `Marker` visible.
`zindex_changed`	`function()` الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير السمة `Marker` zIndex.
`rightclick`	متوقّف نهائيًا: استخدِم الحدث `Marker.contextmenu` بدلاً من ذلك من أجل إتاحة أنماط الاستخدام، مثل النقر مع الضغط على مفتاح Control في نظام التشغيل macOS. `function(event)` الوسيطات: `event`: `MapMouseEvent` يتم تنشيط هذا الحدث عند النقر بزر الماوس الأيمن على `Marker`.

واجهة MarkerOptions

google.maps.MarkerOptions interface

عنصر MarkerOptions المستخدَم لتحديد السمات التي يمكن ضبطها على Marker.

الخصائص
`anchorPoint optional`	النوع: `Point optional` الإزاحة من موضع العلامة إلى طرف InfoWindow الذي تم فتحه باستخدام العلامة كنقطة ارتساء
`animation optional`	النوع: `Animation optional` القيمة التلقائية: `null` تحديد الصورة المتحركة التي سيتم تشغيلها عند إضافة علامة إلى خريطة
`clickable optional`	النوع: `boolean optional` القيمة التلقائية: `true` إذا كانت القيمة `true`، تتلقّى العلامة أحداث الماوس واللمس.
`collisionBehavior optional`	متوقّفة نهائيًا: تم إيقاف `collisionBehavior` نهائيًا اعتبارًا من يوليو 2023. يمكنك استخدام `AdvancedMarkerElement.collisionBehavior` كبديل. ملاحظة: تتوفّر هذه الميزة في قناة الإصدار التجريبي v=beta فقط. النوع: `string\|CollisionBehavior optional` القيمة التلقائية: `null` ضبط سلوك التعارض للعلامات على الخرائط المتّجهة
`crossOnDrag optional`	النوع: `boolean optional` القيمة التلقائية: `true` إذا كانت القيمة `false`، سيتم إيقاف العلامة المتقاطعة التي تظهر أسفل أداة التحديد عند السحب.
`cursor optional`	النوع: `string optional` القيمة التلقائية: `pointer` نوع مؤشر الماوس المطلوب عرضه عند التمرير فوقه
`draggable optional`	النوع: `boolean optional` القيمة التلقائية: `false` إذا كانت القيمة `true`، يمكن سحب العلامة. ملاحظة: سيؤدي ضبط هذا الخيار على `true` إلى إتاحة النقر على العلامة حتى إذا تم ضبط `clickable` على `false`.
`icon optional`	النوع: `string\|Icon\|Symbol optional` رمز المقدّمة في حال توفير سلسلة، يتم التعامل معها كما لو كانت `Icon` مع السلسلة كـ `url`.
`label optional`	النوع: `string\|MarkerLabel optional` القيمة التلقائية: `null` تضيف هذه السمة تصنيفًا إلى العلامة. تسمية العلامة هي حرف أو رقم يظهر داخل علامة. يمكن أن تكون التصنيفات سلسلة أو عنصر `MarkerLabel`. في حال توفير `MarkerOptions.title` وعدم توفيرها، ستتم إضافة نص تسهيل الاستخدام (على سبيل المثال، لاستخدامه مع برامج قراءة الشاشة) إلى العلامة مع نص التصنيف المقدَّم. يُرجى العِلم أنّ `label` يُستخدَم حاليًا فقط لنص تسهيل الاستخدام الخاص بالعلامات غير المحسَّنة.

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

فئة Marker

الشركة المصنِّعة

الثوابت

الطُرق

الفعاليات

واجهة MarkerOptions

الخصائص

Marker (legacy)