مرجع فئة GMSMarker


نظرة عامة

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

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

تكتسب GMSOverlay.

مُكتسَب من GMSAdvancedMarker.

دوال الأعضاء العامة الثابتة

(instancetype)+ markerWithPosition:
 الدالة الإنشائية المناسبة للعلامة التلقائية.
(صورة واجهة المستخدم *)+ markerImageWithColor:
 لإنشاء نسخة ملونة من صورة العلامة التلقائية لاستخدامها كرمز.

المواقع

CLLocationCoordinate2Dالموضع
 موضع العلامة:
NSString * مقتطف
 نص المقتطف، يظهر أسفل العنوان في نافذة المعلومات عند تحديده.
صورة واجهة المستخدم * 
 رمز العلامة المطلوب عرضه
UIView * iconView
 سيتم عرض العلامة.
بولtracksViewChanges
 تتحكّم هذه السياسة في ما إذا كان يجب إعادة رسم رمز هذه العلامة في كل إطار.
بولtracksInfoWindowChanges
 تتحكّم هذه السياسة في ما إذا كان يجب إعادة رسم نافذة المعلومات لهذه العلامة مع كل إطار.
نقطة CGPointgroundAnchor
 يحدد ارتساء الأرض النقطة في صورة الرمز التي يتم إرساؤها في موضع العلامة على سطح الأرض.
نقطة CGPointinfoWindowAnchor
 يحدد ارتساء نافذة المعلومات النقطة في صورة الرمز التي يمكن عندها إرساء نافذة المعلومات، والتي سيتم عرضها أعلى هذه النقطة مباشرةً.
GMSMarkerAnimationappearAnimation
 تتحكّم هذه السياسة في الحركة المستخدمة عندما يتم وضع هذه العلامة على GMSMapView (القيمة التلقائية kGMSMarkerAnimationNone، وبدون رسوم متحركة).
بولالسحب
 تتحكّم هذه السمة في إمكانية سحب هذه العلامة بشكل تفاعلي (خيار "لا" تلقائي).
بولمسطّح
 للتحكم في ما إذا كان يجب أن تكون هذه العلامة مسطحة على سطح الأرض (نعم) أو لوحة إعلانات مواجهة للكاميرا (لا، الإعداد التلقائي).
CLLocationDegreesدوران
 لتعيين تدوير العلامة بالدرجات في اتجاه عقارب الساعة حول نقطة ارتساء العلامة.
float التعتيم
 لتعيين مستوى تعتيم العلامة، بين 0 (شفاف تمامًا) و1 (تلقائي) شامل.
GMSMarkerLayerطبقة
 يوفر طبقة الصورة المتحركة الأساسية لـ GMSMarker هذا.
GMSPanoramaViewpanoramaView
 وتحدّد panoramaView طريقة عرض البانوراما التي ستحاول إظهار هذه العلامة.
NSString * title
 العنوان، وصف موجز للتراكب.
GMSMapViewخريطة
 الخريطة التي يوجد عليها هذا التراكب.
بوليمكن النقر عليها
 ما إذا كان يجب أن يتسبب هذا التراكب في تلقي إشعارات النقر.
int zIndex
 سيتم رسم العناصر المركّبة ذات القيمة zIndex الأعلى فوق طبقات وتراكبات قيم zIndex الأقل.
iduserData
 بيانات التراكب.

وثائق وظائف الأعضاء

+ (instancetype) markerWithPosition: (CLLocationCoordinate2D)  الموضع

الدالة الإنشائية المناسبة للعلامة التلقائية.

+ (UIImage *) markerImageWithColor: (nullable UIColor *)  color (اللون)

لإنشاء نسخة ملونة من صورة العلامة التلقائية لاستخدامها كرمز.


وثائق العقار

- (CLLocationCoordinate2D) position [read, write, assign]

موضع العلامة:

صورة متحركة

- (NSString*) مقتطف [read, write, copy]

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

- (UIImage*) رمز [read, write, assign]

رمز العلامة المطلوب عرضه

في حال عدم إدخال أي قيمة، سيتم استخدام محدّد موقع تلقائي لحزمة تطوير البرامج (SDK).

يدعم الصور المتحركة، ولكن يجب أن يكون كل إطار بنفس الحجم أو أن السلوك غير محدد.

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

- (UIView*) iconView [read, write, assign]

سيتم عرض العلامة.

إذا تركت القيمة فارغة، تعود إلى السمة icon بدلاً من ذلك.

يتيح هذا الإجراء استخدام الصور المتحركة لجميع السمات المتحركة في UIView، باستثناء frame وcenter. لا يمكن تغيير هذه الخصائص أو إصدار CALayer المقابلة لها، بما في ذلك position.

تجدر الإشارة إلى أنّ طريقة العرض تعمل كما لو تم ضبط clipsToBounds على "نعم"، بصرف النظر عن قيمتها الفعلية.

- (BOOL) tracksViewChanges [read, write, assign]

تتحكّم هذه السياسة في ما إذا كان يجب إعادة رسم رمز هذه العلامة في كل إطار.

لاحظ أنه عند تغيير هذا من "لا" إلى "نعم"، يمكن ضمان إعادة رسم الرمز في الإطار التالي.

يتم ضبط الإعدادات التلقائية على "نعم". ليس له أي تأثير إذا كانت قيمة iconView صفرًا.

- (BOOL) tracksInfoWindowChanges [read, write, assign]

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

لاحظ أنه عندما يتغير هذا من "لا" إلى "نعم"، يمكن ضمان إعادة رسم نافذة المعلومات في الإطار التالي.

يتم ضبط الإعدادات التلقائية على NO.

- (CGPoint) groundAnchor [read, write, assign]

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

يتم تحديد هذه النقطة داخل المساحة المستمرة [0.0، 1.0] × [0.0، 1.0]، حيث (0,0) هو أعلى الجانب الأيسر من الصورة، و (1,1) هو الركن الأيمن السفلي.

إذا كانت الصورة تحتوي على محاذاة غير صفرية RectInsets، فإن الجزء العلوي الأيسر والسفلي الأيمن المذكور أعلاه يشيران إلى القسم الداخلي من الصورة.

- (CGPoint) infoWindowAnchor [read, write, assign]

يحدد ارتساء نافذة المعلومات النقطة في صورة الرمز التي يمكن عندها إرساء نافذة المعلومات، والتي سيتم عرضها أعلى هذه النقطة مباشرةً.

هذه النقطة محددة في نفس مساحة groundAnchor.

- (GMSMarkerAnimation) appearAnimation [read, write, assign]

تتحكّم هذه السياسة في الحركة المستخدمة عندما يتم وضع هذه العلامة على GMSMapView (القيمة التلقائية kGMSMarkerAnimationNone، وبدون رسوم متحركة).

- (BOOL) قابل للسحب [read, write, assign]

تتحكّم هذه السمة في إمكانية سحب هذه العلامة بشكل تفاعلي (خيار "لا" تلقائي).

- (BOOL) مسطّح [read, write, assign]

للتحكم في ما إذا كان يجب أن تكون هذه العلامة مسطحة على سطح الأرض (نعم) أو لوحة إعلانات مواجهة للكاميرا (لا، الإعداد التلقائي).

- تدوير (CLLocationDegrees) [read, write, assign]

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

محور الدوران عمودي للعلامة. يتجاوب تدوير 0 مع الموضع الافتراضي للعلامة. صورة متحركة

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

- تعتيم [read, write, assign] (عائم)

لتعيين مستوى تعتيم العلامة، بين 0 (شفاف تمامًا) و1 (تلقائي) شامل.

- طبقةGMSMarkerLayer*) [read, assign]

يوفر طبقة الصورة المتحركة الأساسية لـ GMSMarker هذا.

- (GMSPanoramaView*) panoramaView [read, write, assign]

وتحدّد panoramaView طريقة عرض البانوراما التي ستحاول إظهار هذه العلامة.

لاحظ أنه إذا كان position للعلامة بعيدًا جدًا عن موقع البانوراما الحالي لـ panoramaView، فلن يتم عرضه لأنه سيكون صغيرًا جدًا.

يمكن ضبطه على صفر لإزالة العلامة من أي عرض بانوراما حالي مرفق به.

يمكن عرض علامة على كل من صورة بانوراما وخريطة في الوقت نفسه.

- (NSString*) title [read, write, copy, inherited]

العنوان، وصف موجز للتراكب.

ستعرض بعض التراكبات، مثل العلامات، العنوان على الخريطة. ويكون العنوان أيضًا هو النص التلقائي لتسهيل الاستخدام.

- (GMSMapView*) خريطة [read, write, assign, inherited]

الخريطة التي يوجد عليها هذا التراكب.

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

- (BOOL) قابل للنقر [read, write, assign, inherited]

ما إذا كان يجب أن يتسبب هذا التراكب في تلقي إشعارات النقر.

بعض العناصر المركّبة، مثل العلامات، قابلة للنقر بشكل تلقائي.

- (int) zIndex [read, write, assign, inherited]

سيتم رسم العناصر المركّبة ذات القيمة zIndex الأعلى فوق طبقات وتراكبات قيم zIndex الأقل.

تؤدي القيم المتساوية إلى ترتيب غير محدد للرسم. تُعد العلامات استثناءً، بغض النظر عن zIndex، سيتم رسمها دائمًا فوق طبقات المربعات وغيرها من التراكبات الأخرى التي لا تستند إلى محدِّدات، ويتم اعتبارها فعليًا في مجموعة فهرس z منفصلة مقارنةً بالتراكبات الأخرى.

- (المعرّف) userData [read, write, assign, inherited]

بيانات التراكب.

يمكنك استخدام هذه السمة لربط كائن عشوائي بهذا التراكب. إنّ حزمة تطوير البرامج (SDK) في "خرائط Google" لنظام التشغيل iOS لا تقرأ هذه الخاصية أو تكتبها.

تجدر الإشارة إلى أنّ userData يجب ألا يشتمل على أي مراجع قوية لأي من عناصر "خرائط Google"، وإلا قد يتم إنشاء دورة الاحتفاظ بالبيانات (ما يؤدي إلى منع إصدار العناصر).