محدِّد

تؤدي الفئة النهائية العامة Marker إلى توسيع الكائن

رمز موضوع عند نقطة معينة على سطح الخريطة. يتم رسم رمز العلامة باتجاه شاشة الجهاز بدلاً من سطح الخريطة، على سبيل المثال، لن يتغير الاتجاه بالضرورة بسبب دوران الخريطة أو إمالتها أو تكبيرها/تصغيرها.

تشتمل العلامة على الخصائص التالية:

إصدار أولي
لتعيين درجة تعتيم العلامة. يكون الإعداد التلقائي بالقيمة 1.0.
مرساة
النقطة على الصورة التي سيتم وضعها في موضع LatLng للعلامة. ويكون هذا الخيار تلقائيًا هو 50% من يسار الصورة وأسفلها.
الموضع
القيمة LatLng لموضع العلامة على الخريطة. ويمكنك تغيير هذه القيمة في أي وقت إذا كنت تريد نقل العلامة.
العنوان
سلسلة نصية يتم عرضها في نافذة معلومات عندما ينقر المستخدم على العلامة. ويمكنك تغيير هذه القيمة في أي وقت.
المقتطف
نص إضافي يتم عرضه أسفل العنوان ويمكنك تغيير هذه القيمة في أي وقت.
الرمز
صورة نقطية يتم عرضها للعلامة. وإذا لم يتم ضبط هذا الرمز، سيتم عرض رمز تلقائي. يمكنك تحديد لون بديل للرمز التلقائي باستخدام defaultMarker(float).
حالة السحب
إذا كنت تريد السماح للمستخدم بسحب العلامة، اضبط هذه السمة على true. ويمكنك تغيير هذه القيمة في أي وقت. والقيمة التلقائية هي false.
مستوى العرض
بشكل تلقائي، تكون العلامة مرئية. لإخفاء العلامة، اضبط هذه السمة على false. ويمكنك تغيير هذه القيمة في أي وقت.
مسطّح أو لوحة إعلانات
إذا كانت العلامة مسطّحة على الخريطة، ستظل عالقة على الخريطة أثناء تدوير الكاميرا وإمالتها، ولكنها ستظلّ بنفس حجم الكاميرا، على عكس شاشة GroundOverlay. إذا كانت العلامة عبارة عن لوحة إعلانات، سيتم رسمها دائمًا أمام الكاميرا وسيتم تدويرها وإمالتها باستخدام الكاميرا. اللوحة التلقائية هي لوحة الإعلانات (false).
تدوير
تدوير العلامة بالدرجات في اتجاه عقارب الساعة حول نقطة ارتساء العلامة. ومحور الدوران عمودي للعلامة. يتجاوب تدوير 0 مع الموضع التلقائي للعلامة. عندما تكون العلامة مسطّحة على الخريطة، يكون الموضع التلقائي هو المحاذاة إلى الشمال ويكون التدوير هو أن تظل العلامة مسطّحة على الخريطة دائمًا. عندما تكون العلامة عبارة عن لوحة إعلانات، يكون الوضع التلقائي يشير إلى الأعلى وتكون التدوير بشكل يجعل العلامة موجَّهة للكاميرا دائمًا. القيمة التلقائية هي 0.
zIndex
ترتيب رسم العلامة. يتم رسم العلامات بترتيب zIndex، مع رسم أعلى علامة zIndex في أعلى القائمة. من خلال ضبط سمة zIndex لكل علامة، يمكنك التحكّم في استهداف النقر الذي من المرجّح أن يحقّقه المستخدم. القيمة التلقائية هي 0.
علامة
Object مرتبط بالعلامة. على سبيل المثال، يمكن أن تتضمن Object بيانات حول ما تمثله العلامة. وهذه الطريقة أسهل من تخزين Map<Marker, Object> منفصلة. وكمثال آخر، يمكنك ربط رقم تعريف String مطابق للرقم التعريفي من مجموعة بيانات. إنّ حزمة تطوير البرامج (SDK) في "خرائط Google" لنظام التشغيل Android لا تقرأ هذه السمة ولا تكتبها.

يجب استدعاء الطُرق في هذا الصف في سلسلة محادثات واجهة مستخدم Android. وإذا لم يكن الأمر كذلك، سيتم طرح IllegalStateException في وقت التشغيل.

مثال

GoogleMap map = ... // get a map.
 // Add a marker at San Francisco.
 Marker marker = map.addMarker(new MarkerOptions()
     .position(new LatLng(37.7750, 122.4183))
     .title("San Francisco")
     .snippet("Population: 776733"));

دليل المطوِّر

للحصول على مزيد من المعلومات، اطّلِع على دليل مطوّري العلامات.

ملخص الفئة المدمَجة

@interface Marker.CollisionBehavior تشير إلى كيفية التعامل مع العلامة عند حدوث تصادم مع علامات أخرى أو تصنيفات خرائط أساسية. 

ملخّص الطريقة العلنية

boolean
يساوي(كائن آخر)
لاختبار ما إذا كانت قيمة Marker تساوي قيمة أخرى.
float
getAlpha()
الحصول على ألفا العلامة.
سلسلة
getId()
الحصول على رقم تعريف محدّد الموقع هذا
LatLng
getPosition()
لعرض موضع العلامة.
float
getRotation()
الحصول على تدوير العلامة.
سلسلة
getSnippet()
يمكن الحصول على مقتطف العلامة.
الكائن
getTag()
يحصل على علامة العلامة.
سلسلة
getTitle()
يحصل على عنوان العلامة.
float
getZIndex()
لعرض zIndex للعلامة.
int
hashCode()
void
hideInfoWindow()
إخفاء نافذة المعلومات إذا تم عرضها من هذه العلامة.
boolean
isDraggable()
يتيح إمكانية سحب العلامة.
boolean
isFlat()
الحصول على الإعداد المسطح للعلامة.
boolean
isInfoWindowShown()
لعرض ما إذا كانت نافذة المعلومات تظهر حاليًا أعلى هذه العلامة.
boolean
isVisible()
يحصل على إعداد مستوى الرؤية لهذه العلامة.
void
remove()
لإزالة هذه العلامة من الخريطة.
void
setAlpha(ألفا عائم)
لتعيين ألفا (درجة التعتيم) للعلامة.
void
setAnchor(فاصلة فاصلة عشرية, فاصلة عائمة)
لتعيين نقطة الارتساء للعلامة.
void
setDraggable(منطقية قابلة للسحب)
لتعيين إمكانية سحب العلامة.
void
setFlat(منطقية ثابتة)
تحدِّد هذه السياسة ما إذا كان يجب أن يكون محدّد الموقع مسطّحًا على الخريطة true أو لوحة إعلانات مواجهة للكاميرا false.
void
setIcon(BitmapDescriptor iconDescriptor)
لتعيين رمز العلامة.
void
setInfoWindowAnchor(نقطة ارتساء عائمة، فاصلة عائمة V)
تحدِّد هذه العلامة النقطة في صورة العلامة التي يجب تثبيت نافذة المعلومات عند عرضها.
void
setPosition(LatLng)
لتعيين موقع العلامة.
void
setRotation(دوران عائم)
لتعيين تدوير العلامة بالدرجات في اتجاه عقارب الساعة حول نقطة ارتساء العلامة.
void
setSnippet(مقتطف السلسلة)
لتعيين مقتطف العلامة.
void
setTag(علامة الكائن)
تعيين علامة للعلامة.
void
setTitle(عنوان السلسلة)
لتعيين عنوان العلامة.
void
setVisible(مرئية منطقية)
تعيين مستوى رؤية هذه العلامة.
void
setZIndex(قيمة عائمة لمؤشر zIndex)
لضبط zIndex للعلامة.
void
showInfoWindow()
يعرض نافذة المعلومات الخاصة بهذا محدّد على الخريطة، إذا كانت هذه العلامة isVisible().

ملخّص الطريقة المكتسبة

الطرق العامة

منطقية عامة يساوي (كائن آخر)

لاختبار ما إذا كانت قيمة Marker تساوي قيمة أخرى.

المَعلمات
غير ذلك Object.
المرتجعات
  • true إذا كان كلا الكائنين نفس الكائن، أي أن == other.

عامة عائمة getAlpha ()

الحصول على ألفا العلامة.

المرتجعات
  • ألفا للعلامة في النطاق [0، 1].

public سلسلة getId ()

الحصول على رقم تعريف محدّد الموقع هذا سيكون المعرف فريدًا بين جميع "العلامات" على الخريطة.

المرتجعات
  • معرف العلامة هذه.

عامة LatLng getPosition ()

لعرض موضع العلامة.

المرتجعات
  • عنصر LatLng يحدّد الموضع الحالي للعلامة.

عامة عائمة getRotation ()

الحصول على تدوير العلامة.

المرتجعات
  • تدوير العلامة بالدرجات في اتجاه عقارب الساعة من الموضع الافتراضي.

public سلسلة getSnippet ()

يمكن الحصول على مقتطف العلامة.

المرتجعات
  • سلسلة تحتوي على مقتطف العلامة.

public Object getTag ()

يحصل على علامة العلامة.

المرتجعات
  • العلامة في حال ضبط العلامة باستخدام setTag، وnull في حال عدم ضبط أي علامة.

public سلسلة getTitle ()

يحصل على عنوان العلامة.

المرتجعات
  • سلسلة تحتوي على عنوان العلامة.

عدد عائم getZIndex ()

لعرض zIndex للعلامة.

المرتجعات
  • zIndex لهذه العلامة.

public int hashCode ()

إلغاء عام hideInfoWindow ()

إخفاء نافذة المعلومات إذا تم عرضها من هذه العلامة.

ليس لهذه الطريقة أي تأثير إذا لم تكن هذه العلامة مرئية.

عامة منطقية isDraggable ()

يتيح إمكانية سحب العلامة. عندما تكون العلامة قابلة للسحب، يمكن للمستخدم نقلها من خلال الضغط مع الاستمرار على العلامة.

المرتجعات
  • true إذا كانت العلامة قابلة للسحب، وإلا سيتم عرض false.

عامة منطقية isFlat ()

الحصول على الإعداد المسطح للعلامة.

المرتجعات
  • true إذا كان محدّد الموقع مسطّحًا على الخريطة، وfalse إذا كان يجب أن يكون محدّد الموقع مواجهًا للكاميرا.

عامة منطقية isInfoWindowShown ()

لعرض ما إذا كانت نافذة المعلومات تظهر حاليًا أعلى هذه العلامة. ولا يأخذ في الاعتبار ما إذا كانت نافذة المعلومات مرئية على الشاشة أم لا.

عامة منطقية isVisible ()

يحصل على إعداد مستوى الرؤية لهذه العلامة. تجدر الإشارة إلى أنّ هذا لا يشير إلى ما إذا كانت العلامة ضمن إطار العرض على الشاشة. وهي تشير إلى ما إذا كان سيتم رسم العلامة إذا كانت مضمَّنة في إطار العرض للشاشة.

المرتجعات
  • رؤية هذه العلامة.

إلغاء عام إزالة ()

لإزالة هذه العلامة من الخريطة. وبعد إزالة العلامة، يصبح سلوك جميع الطرق غير محدد.

إلغاء علني setAlpha (ألفا عائم)

لتعيين ألفا (درجة التعتيم) للعلامة. وتكون هذه القيمة بين 0 و1، حيث يعني 0 أنّ العلامة شفافة تمامًا و1 تعني أنّ العلامة معتمة تمامًا.

المَعلمات
إصدار تجريبي أول

إبطال عام setAnchor (فاصلة فاصلة عشرية, فاصلة عائمة V)

لتعيين نقطة الارتساء للعلامة.

يحدد ارتساء النقطة في صورة الرمز النقطة التي تم تثبيتها في موضع العلامة على سطح الأرض.

يتم تحديد نقطة الارتساء في المساحة المستمرة [0.0، 1.0] × [0.0، 1.0]، حيث يمثّل (0، 0) الزاوية العلوية اليسرى من الصورة، و (1، 1) هو الزاوية السفلية اليمنى من الصورة. نقطة الارتساء في صورة بتنسيق عرض x ارتفاع هي أقرب نقطة شبكة منفصلة في شبكة (عرض + 1) × (ارتفاع + 1)، ويتم الحصول عليها من خلال ضبط قياس التقريب ثم التقريب. على سبيل المثال، في صورة بحجم 4 × 2، تتم إعادة ضبط نقطة الارتساء (0.7، 0.6) مع نقطة الشبكة عند (3، 1). 

 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----+-----+
 |     |     |   X |     |   (U, V) = (0.7, 0.6)
 |     |     |     |     |
 *-----+-----+-----+-----*
 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----X-----+   (X, Y) = (3, 1)
 |     |     |     |     |
 |     |     |     |     |
 *-----+-----+-----+-----*

المَعلمات
anchorU الإحداثي u-لالمراسي، كنسبة عرض الصورة (في النطاق [0، 1]).
anchorV والإحداثي v-لمراسي الارتساء كنسبة لارتفاع الصورة (في النطاق [0، 1]).

إلغاء علني setDraggable (boolean draggable)

لتعيين إمكانية سحب العلامة. عندما تكون العلامة قابلة للسحب، يمكن للمستخدم نقلها من خلال الضغط مع الاستمرار على العلامة.

المَعلمات
عنصر قابل للسحب

خطأ علني setFlat (منطقيّ مستوٍ)

تحدِّد هذه السياسة ما إذا كان يجب أن يكون محدّد الموقع مسطّحًا على الخريطة true أو لوحة إعلانات مواجهة للكاميرا false.

المَعلمات
نغمة خفيضة

إلغاء علني setIcon (BitmapDescriptor iconDescriptor)

لتعيين رمز العلامة.

المَعلمات
iconDescriptor إذا كانت قيمة فارغة، فسيتم استخدام العلامة الافتراضية.

إبطال عام setInfoWindowAnchor (فاصلة فاصلة عشرية, فاصلة عائمة)

تحدِّد هذه العلامة النقطة في صورة العلامة التي يجب تثبيت نافذة المعلومات عند عرضها. يتم تحديد ذلك في نفس نظام الإحداثيات مثل علامة الارتساء. لمزيد من التفاصيل، يُرجى الانتقال إلى setAnchor(float, float). الإعداد التلقائي هو منتصف الجزء العلوي من الصورة.

المَعلمات
anchorU الإحداثي u لارتساء نافذة المعلومات، كنسبة عرض الصورة (في النطاق [0، 1]).
anchorV والإحداثي v لارتساء نافذة المعلومات، كنسبة لارتفاع الصورة (في النطاق [0، 1]).

إبطال عام setPosition (LatLng (خط الطول والعرض)

لتعيين موقع العلامة.

المَعلمات
خط الطول والعرض

إلغاء عام setRotation (دوران عائم)

لتعيين تدوير العلامة بالدرجات في اتجاه عقارب الساعة حول نقطة ارتساء العلامة. ومحور الدوران عمودي للعلامة. يتجاوب تدوير 0 مع الموضع الافتراضي للعلامة.

المَعلمات
دوران

إبطال عام setSnippet (مقتطف السلسلة)

لتعيين مقتطف العلامة.

المَعلمات
مقتطف وإذا كانت فارغة، يتم محو المقتطف.

إلغاء عام setTag (علامة الكائن)

تعيين علامة للعلامة.

يمكنك استخدام هذه السمة لربط Object عشوائي بهذه العلامة. على سبيل المثال، يمكن أن يحتوي Object على بيانات حول ما تمثله العلامة. وهذه الطريقة أسهل من تخزين Map<Marker, Object> منفصلة. وكمثال آخر، يمكنك ربط رقم تعريف String متوافق مع المعرّف من مجموعة بيانات. إنّ حزمة تطوير البرامج (SDK) في "خرائط Google" لنظام التشغيل Android لا تقرأ هذه السمة ولا تكتبها. تقع على عاتقك مسؤولية طلب الرقم setTag(null) لمحو العلامة عند الاستغناء عنها، وذلك لمنع تسرُّب الذاكرة في تطبيقك.

المَعلمات
العلامة وإذا كانت قيمة فارغة، فسيتم محو العلامة.

إلغاء عام setTitle (عنوان السلسلة)

لتعيين عنوان العلامة.

المَعلمات
العنوان إذا كانت قيمة فارغة، فسيتم محو العنوان.

فراغ علني setVisible (boolean visible)

تعيين مستوى رؤية هذه العلامة. في حال ضبط هذه السياسة على false وكانت هناك نافذة معلومات تظهر حاليًا لهذه العلامة، سيؤدي ذلك إلى إخفاء نافذة المعلومات.

المَعلمات
مرئي

إلغاء علني setZIndex (float zIndex)

لضبط zIndex للعلامة.

المَعلمات
zIndex

إلغاء عام showInfoWindow ()

يعرض نافذة المعلومات الخاصة بهذا محدّد على الخريطة، إذا كانت هذه العلامة isVisible().

الرميات
IllegalArgumentException إذا لم يكن marker على هذه الخريطة