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

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

محدِّد

حصة نهائية علنية محدِّد الموقع توسيع Object

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

تضم العلامة السمات التالية:

إصدار أولي: لضبط درجة تعتيم العلامة. القيمة التلقائية هي 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 يشير إلى كيفية التعامل مع العلامة عند وقوع تصادم مع علامات أو قاعدة أخرى تصنيفات الخريطة.

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

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

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

من الصف java.lang.Object

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

الطرق العامة

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

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

المعلمات

غير ذلك	`Object`

المرتجعات

true إذا كان الكائنان في نفس الكائن، أي أن == other.

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

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

المرتجعات

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

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

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

المرتجعات

مُعرّف هذه العلامة.

علنية LatLng getPosition ()

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

المرتجعات

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

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

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

المرتجعات

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

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

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

المرتجعات

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

علنية كائن getTag ()

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

المرتجعات

العلامة إذا تمّ ضبط علامة باستخدام setTag null في حال عدم ضبط أي علامة

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

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

المرتجعات

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

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

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

المرتجعات

zIndex لهذه العلامة.

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

علنية فراغ hideInfoWindow ()

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

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

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

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

المرتجعات

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

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

الحصول على الإعداد المسطح لأداة التحديد

المرتجعات

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

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

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

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

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

المرتجعات

ظهور هذه العلامة.

علنية فراغ إزالة ()

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

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

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

المعلمات

ألفا

علنية فراغ setAnchor (float AnchorU, float AnchorV)

لضبط نقطة الارتساء للعلامة

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

يتم تحديد نقطة الارتساء في المسافة المستمرة [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)
 |     |     |     |     |
 |     |     |     |     |
 *-----+-----+-----+-----*

المعلمات

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

علنية فراغ setDraggable (قابلة للسحب المنطقي)

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

المعلمات

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

علنية فراغ setFlat (قيمة منطقية مسطحة)

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

المعلمات

نغمة خفيضة

علنية فراغ setIcon (BitmapDescriptor iconDescriptor)

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

المعلمات

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

علنية فراغ setInfoWindowAnchor (float AnchorU, float AnchorV)

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

المعلمات

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

علنية فراغ setPosition (LatLng خط الطول)

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

المعلمات

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

علنية فراغ setRotation (تدوير عائم)

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

المعلمات

تدوير

علنية فراغ setSnippet (مقتطف السلسلة)

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

المعلمات

مقتطف	إذا كانت القيمة خالية، يتم محو المقتطف.

علنية فراغ setTag (علامة الكائن)

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

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

المعلمات

علامة	إذا كانت القيمة خالية، يتم محو العلامة.

علنية فراغ setTitle (عنوان السلسلة)

لضبط عنوان العلامة.

المعلمات

title	إذا كانت القيمة خالية، يتم محو العنوان.

علنية فراغ setVisible (قيمة منطقية مرئية)

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

المعلمات

مرئي

علنية فراغ setZIndex (المؤشر z العشري)

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

المعلمات

zIndex

علنية فراغ showInfoWindow ()

إظهار نافذة معلومات هذه العلامة على الخريطة، إذا كانت هذه العلامة isVisible().

الرميات

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