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

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

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

الفئة النهائية العامة MarkerOptions تعمل على توسيع الكائن
وتنفِّذ Parcelable

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

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

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

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

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

int	CONTENTS_FILE_DESCRIPTOR
int	PARCELABLE_WRITE_RETURN_VALUE

ملخّص عام للمنشئ

MarkerOptions()

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

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

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

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

من الفئة java.lang.Object

boolean	equals(كائن arg0)
الفئة النهائية<?>	getClass()
int	hashCode()
الفراغ الأخير	notify()
الفراغ الأخير	notifyAll()
سلسلة	toString()
الفراغ الأخير	انتظار(long arg0, int arg1)
الفراغ الأخير	انتظار(طول طويل arg0)
الفراغ الأخير	نحن()

من واجهة 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) هو الزاوية السفلية اليمنى من الصورة. نقطة الارتساء في صورة بتنسيق عرض x ارتفاع هي أقرب نقطة شبكة منفصلة في شبكة (عرض + 1) × (ارتفاع + 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])

المرتجعات

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

public MarkerOptions collisionBehavior (int collisionBehavior)

لتعيين حالة التصادم للعلامة. هذه القيمة Marker.CollisionBehavior. يمكن ضبطها مرة واحدة فقط.

المَعلمات

collisionBehavior

المرتجعات

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

عامة MarkerOptions draggable (boolean draggable)

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

المَعلمات

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

المرتجعات

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

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

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

المَعلمات

نغمة خفيضة

المرتجعات

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

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

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

المرتجعات

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

عامة عائمة getAnchorU ()

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

المرتجعات

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

عامة عائمة getAnchorV ()

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

المرتجعات

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

public int getCollisionBehavior ()

public BitmapDescriptor getIcon ()

تتيح هذه السياسة ضبط أداة وصف الرموز المخصّصة لعنصر MarkerOptions هذا.

المرتجعات

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

public float getInfoWindowAnchorU ()

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

المرتجعات

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

عامة عائمة getInfoWindowAnchorV ()

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

المرتجعات

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

عامة LatLng getPosition ()

لعرض الموضع الذي تم ضبطه لكائن MarkerOptions هذا.

المرتجعات

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

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

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

المرتجعات

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

public سلسلة getSnippet ()

يتم ضبط المقتطف لعنصر MarkerOptions هذا.

المرتجعات

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

public سلسلة 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 position (LatLng latlng)

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

المَعلمات

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

المرتجعات

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

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

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

المَعلمات

دوران

المرتجعات

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

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

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

المَعلمات

مقتطف

المرتجعات

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

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

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

المَعلمات

العنوان

المرتجعات

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

عامة MarkerOptions visible (boolean visible)

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

المَعلمات

مرئي

المرتجعات

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

خيار متاح للجميع MarkerOptions zIndex (float zIndex)

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

المَعلمات

zIndex

المرتجعات

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