مرجع فئةض تحديد العلامات


نظرة عامة

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

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

يكتسب GMSoverlay.

وظائف الأعضاء العامة الثابتة

(مثال)+ markerWithPosition:
 أداة إنشاء سهلة الاستخدام لمحدِّد مواقع تلقائي.
(UIImage *)+ markerImageWithColor:
 لإنشاء نسخة ملونة من صورة العلامة الافتراضية لاستخدامها كرمز.

المواقع

CLLocationCoordinate2Dالموضع
 موضع محدّد الموقع.
NSString * مقتطف
 نص مقتطف يظهر أسفل العنوان في نافذة المعلومات عند تحديده.
UIImage * رمز
 رمز العلامة المراد عرضه.
UIView * iconView
 عرض العلامة المراد عرضها.
قيمة منطقيةtracksViewChanges
 يتحكم هذا الإعداد في ما إذا كان يجب إعادة رسم رمز هذه العلامة في كل إطار.
قيمة منطقيةtracksInfoWindowChanges
 يتحكم هذا الإعداد في ما إذا كان يجب إعادة رسم نافذة المعلومات لهذه العلامة في كل إطار.
CGPointgroundanchor
 يحدد إرساء الأرض النقطة في صورة الرمز التي يتم تثبيتها في موضع العلامة على سطح الأرض.
CGPointinfoWindowAnchor
 تحدد علامة ارتساء نافذة المعلومات النقطة في صورة الرمز لإرساء نافذة المعلومات، والتي سيتم عرضها أعلى هذه النقطة مباشرة.
GMSMarkerAnimationرسم متحرك
 للتحكم في الحركة المستخدمة عند وضع هذه العلامة على GMSMapView (افتراضي kGMSMarkerAnimationNone، بلا حركة).
قيمة منطقيةالقابل للسحب
 للتحكم في ما إذا كان يمكن سحب هذه العلامة بشكل تفاعلي (لا).
قيمة منطقيةمسطَّح
 للتحكم في ما إذا كان من المفترض أن تكون هذه العلامة مسطحة على سطح الأرض (نعم) أو لوحة إعلانات مواجهة للكاميرا (لا، افتراضي).
CLLocationDegreesالتدوير
 لتعيين تدوير العلامة بالدرجات في اتجاه عقارب الساعة على نقطة الارتساء للعلامة.
عدد عائمالتعتيم
 لتعيين تعتيم العلامة، بين 0 (شفاف تمامًا) و1 (افتراضي) بشكل شامل.
GMSMarkerLayer * layer (طبقة)
 يوفر طبقة الرسوم المتحركة الأساسية لـ GMSMarker هذا.
GMSPanoramaViewpanoramaView
 تحدد panoramaView طريقة عرض البانوراما التي ستحاول عرض هذه العلامة.
NSString * title
 عنوان، وصف قصير للتراكب.
GMSMapViewخريطة
 الخريطة التي يتراكب عليها هذا التراكب.
قيمة منطقيةملموس
 إذا كان هذا التراكب من المفترض أن يتسبب في تلقي إشعارات النقر،
عدد صحيحzindex
 سيتم رسم تراكبات قيمة أعلى بقيمة zIndex في أعلى طبقات الفئات الأقل قيمة لـ zIndex وقيمها.
المعرّفبيانات المستخدمين
 بيانات التراكب.

وثائق وظيفة العضو

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

أداة إنشاء سهلة الاستخدام لمحدِّد مواقع تلقائي.

+ (UIImage *) markerImageWithColor: (واجهة مستخدم خالية من الألوان *) color (اللون)

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


وثائق الملكية

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

موضع محدّد الموقع.

الصور المتحركة.

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

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

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

رمز العلامة المراد عرضه.

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

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

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

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

عرض العلامة المراد عرضها.

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

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

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

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

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

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

الإعداد التلقائي إلى YES. ليس هناك أي تأثير إذا كان iconView صفرًا.

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

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

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

الإعداد التلقائي هو "لا".

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

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

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

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

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

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

يتم تحديد هذه النقطة داخل المساحة نفسها مثل EarthAnchor.

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

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

- (قيمة منطقية) قابلة للسحب [read, write, assign]

للتحكم في ما إذا كان يمكن سحب هذه العلامة بشكل تفاعلي (لا).

- (مائل) مسطَّح [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*) العنوان [read, write, copy, inherited]

عنوان، وصف قصير للتراكب.

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

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

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

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

- (قيمة منطقية) قابلة للتتبّع [read, write, assign, inherited]

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

سيتم ضبط بعض التراكبات بشكل افتراضي لتكون قابلة للنقر عليها، مثل المحددات.

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

سيتم رسم تراكبات قيمة أعلى بقيمة zIndex في أعلى طبقات الفئات الأقل قيمة لـ zIndex وقيمها.

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

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

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

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

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