سيتوفّر تصميم الخريطة الجديد قريبًا على "منصة خرائط Google". يتضمن هذا التحديث على تصميم الخريطة لوحة ألوان تلقائية جديدة وتحسينات على تجارب الخرائط وسهولة الاستخدام. سيتم تعديل جميع أنماط الخرائط تلقائيًا في آذار (مارس) 2025. للمزيد من المعلومات عن مدى التوفّر وكيفية تفعيل الميزة في وقت سابق، يُرجى الاطّلاع على نمط الخريطة الجديد في "منصة خرائط Google".

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

خيارات العلامة

حصة نهائية علنية MarkerOptions توسيع Object
implements قطع غيار المناطق

يحدد MarkerOptions للعلامة.

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

للمزيد من المعلومات، يُرجى الاطّلاع على مطوِّر برامج العلامات. الدليل.

ملخّص ثابت مكتسَب

من الواجهة android.os.Parcelable

int	CONTENTS_FILE_DESCRIPTOR
int	PARCELABLE_WRITE_RETURN_VALUE

ملخّص الإنشاء العام

MarkerOptions()

تنشئ مجموعة جديدة من خيارات العلامة.

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

MarkerOptions	alpha(ألفا عائم) لتعيين ألفا (معدل الشفافية) للعلامة.
MarkerOptions	ارتساء(float u, float v) لتحديد علامة الارتساء لتكون عند نقطة معينة في صورة العلامة.
MarkerOptions	collisionBehavior(سلوك التصادم الداخلي) لتعيين حالة التصادم للعلامة.
MarkerOptions	draggable(منطقية قابلة للسحب) تعيين قابلية السحب للعلامة.
MarkerOptions	مسطّح(مسطّح منطقي) لضبط ما إذا كان يجب أن تكون هذه العلامة مسطّحة على الخريطة `true` أو لوحة إعلانات مواجهة الكاميرا `false`.
عدد عائم	getAlpha() للحصول على مجموعة ألفا لهذا الكائن `MarkerOptions`.
عدد عائم	getAnchorU() المسافة الأفقية، بعد تسويتها على [0، 1]، للارتساء من الحافة اليسرى.
عدد عائم	getAnchorV() المسافة الرأسية، بعد تسويتها على [0، 1]، للمرساة من الحافة العلوية.
int	getCollisionBehavior()
BitmapDescriptor	getIcon() للحصول على مجموعة واصف الرموز المخصّصة لعنصر `MarkerOptions` هذا.
عدد عائم	getInfoWindowAnchorU() المسافة الأفقية، بعد تسويتها على [0، 1]، من ارتساء نافذة المعلومات من الحافة اليسرى
عدد عائم	getInfoWindowAnchorV() المسافة الرأسية، بعد تسويتها على [0، 1]، من ارتساء نافذة المعلومات من الحافة العلوية.
LatLng	getPosition() تعرض الموضع المحدّد لهذا العنصر في `MarkerOptions`.
عدد عائم	getRotation() الحصول على ضبط التدوير لهذا العنصر `MarkerOptions`.
سلسلة	getSnippet() للحصول على مجموعة المقتطف لهذا الكائن `MarkerOptions`.
سلسلة	getTitle() الحصول على مجموعة العنوان لهذا الكائن `MarkerOptions`
عدد عائم	getZIndex() للحصول على مجموعة zIndex لهذا الكائن `MarkerOptions`.
MarkerOptions	icon(BitmapDescriptor iconDescriptor) لتعيين الرمز للعلامة.
MarkerOptions	infoWindowAnchor(float u, float v) لتحديد نقطة ارتساء نافذة المعلومات على صورة العلامة.
منطقي	isDraggable() توفر هذه السياسة إعداد إمكانية السحب للعنصر `MarkerOptions` هذا.
منطقي	isFlat() تتيح هذه السياسة الحصول على الإعداد الثابت للعنصر `MarkerOptions`.
منطقي	isVisible() تتيح هذه السياسة الحصول على إعدادات مستوى الرؤية لهذا الكائن `MarkerOptions`.
MarkerOptions	position(LatLng latlng) لتعيين موقع العلامة.
MarkerOptions	التدوير(التدوير العائم) تعيين تدوير العلامة بالدرجات في اتجاه عقارب الساعة حول نقطة ارتساء العلامة.
MarkerOptions	المقتطف(مقتطف السلسلة) لتعيين المقتطف للعلامة.
MarkerOptions	title(عنوان السلسلة) لضبط عنوان محدّد الموقع.
MarkerOptions	visible(boolean visible) تعيين مستوى الرؤية للعلامة.
MarkerOptions	zIndex(فئة zIndex بقيمة عائمة) تعيين zIndex للعلامة.

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

من الصف java.lang.Object

منطقي	يساوي(Object arg0)
النِّهَائِي الصف<?>	getClass()
int	hashCode()
النِّهَائِي فراغ	notify()
النِّهَائِي فراغ	notifyAll()
سلسلة	toString()
النِّهَائِي فراغ	wait(long arg0, int arg1)
النِّهَائِي فراغ	wait(long arg0)
النِّهَائِي فراغ	wait()

من الواجهة android.os.Parcelable

تجريدي تدخُّل دفاعي	describeContents()
تجريدي فراغ	writeToParcel(Parcel arg0, int arg1)

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

علنية MarkerOptions ()

تنشئ مجموعة جديدة من خيارات العلامة.

الطرق العامة

علنية MarkerOptions الإصدار الأولي (ألفا عائمة)

لتعيين ألفا (معدل الشفافية) للعلامة. هذه قيمة من 0 إلى 1، حيث يعني 0 علامة شفافة تمامًا وتعني 1 أن العلامة معتمة تمامًا.

المعلمات

ألفا

المرتجعات

هو الكائن الذي استدعيت الطريقة من أجله، مع مجموعة ألفا الجديدة.

علنية MarkerOptions إعلان ثابت (float u, float v)

لتحديد علامة الارتساء لتكون عند نقطة معينة في صورة العلامة.

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

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

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

المعلمات

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

المرتجعات

الكائن الذي تم استدعاء الطريقة له، مع مجموعة الارتساء الجديدة.

علنية MarkerOptions collisionBehavior (سلوك التصادم الداخلي)

لتعيين حالة التصادم للعلامة. هذه قيمة تساوي Marker.CollisionBehavior. مُمْكِنْ يمكن تعيينها مرة واحدة فقط.

المعلمات

collisionBehavior

المرتجعات

الكائن الذي استدعيت الطريقة من أجله، مع تعيين حالة التصادم.

علنية MarkerOptions قابل للسحب (قابلة للسحب المنطقي)

تعيين قابلية السحب للعلامة.

المعلمات

عنصر قابل للسحب

المرتجعات

الكائن الذي استدعيت الطريقة من أجله، مع تعيين الحالة الجديدة القابلة للسحب.

علنية MarkerOptions مسطّح (قيمة منطقية مسطحة)

لضبط ما إذا كان يجب أن تكون هذه العلامة مسطّحة على الخريطة true أو لوحة إعلانات مواجهة الكاميرا false. إذا كانت العلامة مسطّحة على الخريطة، ستظل عالقة على الخريطة يتم تدوير الكاميرا وإمالتها ولكنها ستظل بالحجم نفسه الذي يتم تكبيره أو تصغيره، على عكس GroundOverlay إذا كانت محدّد الموقع عبارة عن لوحة إعلانات، سيتم رسمها دائمًا بمواجهة الكاميرا وسيتم تدويرها وإمالتها باستخدام الكاميرا. القيمة التلقائية هي false.

المعلمات

نغمة خفيضة

المرتجعات

الكائن الذي تم استدعاء الطريقة له، مع تعيين الحالة المسطحة الجديدة.

علنية عدد عائم getAlpha ()

للحصول على مجموعة ألفا لهذا الكائن MarkerOptions.

المرتجعات

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

علنية عدد عائم getAnchorU ()

المسافة الأفقية، بعد تسويتها على [0، 1]، للارتساء من الحافة اليسرى.

المرتجعات

قيمة u للارتساء.

علنية عدد عائم getAnchorV ()

المسافة الرأسية، بعد تسويتها على [0، 1]، للمرساة من الحافة العلوية.

المرتجعات

قيمة v للارتساء.

علنية تدخُّل دفاعي getCollisionBehavior ()

علنية BitmapDescriptor getIcon ()

للحصول على مجموعة واصف الرموز المخصّصة لعنصر MarkerOptions هذا.

المرتجعات

تمثّل هذه السمة BitmapDescriptor الرمز المخصّص أو السمة null في حال عدم توفّرها. تم تعيين رمزه.

علنية عدد عائم getInfoWindowAnchorU ()

المسافة الأفقية، بعد تسويتها على [0، 1]، من ارتساء نافذة المعلومات من الحافة اليسرى

المرتجعات

القيمة u لارتساء نافذة المعلومات.

علنية عدد عائم getInfoWindowAnchorV ()

المسافة الرأسية، بعد تسويتها على [0، 1]، من ارتساء نافذة المعلومات من الحافة العلوية.

المرتجعات

قيمة v لارتساء نافذة المعلومات.

علنية LatLng getPosition ()

تعرض الموضع المحدّد لهذا العنصر في MarkerOptions.

المرتجعات

كائن LatLng يحدد الموضع الحالي للعلامة

علنية عدد عائم getRotation ()

يؤدي إلى ضبط التدوير لهذا العنصر MarkerOptions.

المرتجعات

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

علنية السلسلة getSnippet ()

للحصول على مجموعة المقتطف لهذا الكائن MarkerOptions.

المرتجعات

سلسلة تحتوي على مقتطف العلامة

علنية السلسلة getTitle ()

الحصول على مجموعة العنوان لهذا الكائن MarkerOptions

المرتجعات

سلسلة تحتوي على عنوان العلامة

علنية عدد عائم getZIndex ()

للحصول على مجموعة zIndex لهذا الكائن MarkerOptions.

المرتجعات

zIndex للعلامة.

علنية MarkerOptions الرمز (BitmapDescriptor iconDescriptor)

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

المعلمات

iconDescriptor	إذا كانت `null`، يتم استخدام العلامة التلقائية.

المرتجعات

الكائن الذي استدعيت الطريقة من أجله، مع تعيين واصف الأيقونة الجديد.

علنية MarkerOptions infoWindowAnchor (float u, float v)

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

المعلمات

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

المرتجعات

الكائن الذي تم استدعاء الطريقة له، مع تعيين علامة الارتساء لنافذة المعلومات الجديدة.

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

توفر هذه السياسة إعداد إمكانية السحب للعنصر MarkerOptions هذا.

المرتجعات

true إذا كانت العلامة قابلة للسحب؛ في الحالات الأخرى، سيتم إرجاع false.

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

تتيح هذه السياسة الحصول على الإعداد الثابت للعنصر MarkerOptions.

المرتجعات

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

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

تتيح هذه السياسة الحصول على إعدادات مستوى الرؤية لهذا الكائن MarkerOptions.

المرتجعات

true إذا كانت العلامة مرئية؛ في الحالات الأخرى، سيتم إرجاع false.

علنية MarkerOptions الموضع (LatLng خط الطول والعرض)

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

المعلمات

خط الطول والعرض

المرتجعات

الكائن الذي تم استدعاء الطريقة له، مع تعيين الموضع الجديد.

علنية MarkerOptions تغيير الإعلانات (تدوير عائم)

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

المعلمات

تدوير

المرتجعات

الكائن الذي تم استدعاء الطريقة له، مع تعيين التدوير الجديد.

علنية MarkerOptions المقتطف (مقتطف السلسلة)

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

المعلمات

مقتطف

المرتجعات

الكائن الذي تم استدعاء الطريقة له، مع مجموعة المقتطف الجديدة.

علنية MarkerOptions العنوان (عنوان السلسلة)

لضبط عنوان محدّد الموقع.

المعلمات

title

المرتجعات

الكائن الذي تم استدعاء الطريقة له بمجموعة العنوان الجديدة.

علنية MarkerOptions مرئي (قيمة منطقية مرئية)

تعيين مستوى الرؤية للعلامة.

المعلمات

مرئي

المرتجعات

الكائن الذي تم استدعاء الطريقة له، مع تعيين حالة الرؤية الجديدة.

علنية MarkerOptions zIndex (قيمة zIndex بقيمة عائمة)

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

المعلمات

zIndex

المرتجعات

الكائن الذي استدعيت الطريقة من أجله، مع تعيين zIndex الجديدة.