رمز موضوع عند نقطة معينة على سطح الخريطة. يتم رسم رمز العلامة باتجاه شاشة الجهاز بدلاً من سطح الخريطة، على سبيل المثال، لن يتغير الاتجاه بالضرورة بسبب دوران الخريطة أو إمالتها أو تكبيرها/تصغيرها.
تشتمل العلامة على الخصائص التالية:
- إصدار أولي
- لتعيين درجة تعتيم العلامة. يكون الإعداد التلقائي بالقيمة 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 | |
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 | |
void |
setInfoWindowAnchor(نقطة ارتساء عائمة، فاصلة عائمة V)
تحدِّد هذه العلامة النقطة في صورة العلامة التي يجب تثبيت نافذة المعلومات عند عرضها.
|
void | |
void |
setRotation(دوران عائم)
لتعيين تدوير العلامة بالدرجات في اتجاه عقارب الساعة حول نقطة ارتساء العلامة.
|
void |
setSnippet(مقتطف السلسلة)
لتعيين مقتطف العلامة.
|
void |
setTag(علامة الكائن)
تعيين علامة للعلامة.
|
void |
setTitle(عنوان السلسلة)
لتعيين عنوان العلامة.
|
void |
setVisible(مرئية منطقية)
تعيين مستوى رؤية هذه العلامة.
|
void |
setZIndex(قيمة عائمة لمؤشر zIndex)
لضبط zIndex للعلامة.
|
void |
showInfoWindow()
يعرض نافذة المعلومات الخاصة بهذا محدّد على الخريطة، إذا كانت هذه العلامة
isVisible() . |
ملخّص الطريقة المكتسبة
الطرق العامة
منطقية عامة يساوي (كائن آخر)
عامة عائمة getAlpha ()
الحصول على ألفا العلامة.
المرتجعات
- ألفا للعلامة في النطاق [0، 1].
public سلسلة getId ()
الحصول على رقم تعريف محدّد الموقع هذا سيكون المعرف فريدًا بين جميع "العلامات" على الخريطة.
المرتجعات
- معرف العلامة هذه.
عامة عائمة 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]). |
إلغاء عام 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 على هذه الخريطة
|
---|