مرجع الفئة GMSGroundرز


نظرة عامة

يحدد الإعداد GMSGroundOverlay الخيارات المتاحة لتراكب الأرض الموجود على سطح الأرض.

على عكس العلامة، يتم تحديد موضع التراكب الأرضي بشكل صريح ولا يكون واجهة التطبيق مواجهة للكاميرا.

تكتسب GMSOverlay.

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

(instancetype)+ groundOverlayWithBounds:icon:
 دالة إنشاء ملائمة لـ GMSGroundOverlay لـ bounds وicon محدَّدين.
(instancetype)+ groundOverlayWithPosition:icon:zoomLevel:
 تنشئ هذه الدالة GMSGroundOverlay يعرض icon المحدّد في position، كما لو كان الحجم الفعلي للصورة يتطابق مع وحدات بكسل الكاميرا في zoomLevel.

المواقع

CLLocationCoordinate2Dالموضع
 تمثّل هذه السمة موضع GMSGroundOverlay هذا، أو الموضع الفعلي لمرْساء الرابط.
نقطة CGPointإرساء
 وتحدِّد علامة الارتساء مكان تثبيت GMSGroundOverlay هذا على الأرض في ما يتعلق بـ bounds.
صورة واجهة المستخدم * 
 رمز للعرض ضمن bounds على الأرض.
float التعتيم
 يتم ضبط درجة تعتيم تراكب الأرض، بحيث يتراوح بين 0 (شفاف تمامًا) و1 (تلقائي) بشكل شامل.
CLLocationDirectionتحمل
 اتجاه التراكب الأرضي هذا، بالدرجات.
GMSCoordinateBoundsالحدود
 الحدود الثنائية الأبعاد على الأرض حيث يتم رسم icon.
NSString * title
 العنوان، وصف موجز للتراكب.
GMSMapViewخريطة
 الخريطة التي يوجد عليها هذا التراكب.
بوليمكن النقر عليها
 ما إذا كان يجب أن يتسبب هذا التراكب في تلقي إشعارات النقر.
int zIndex
 سيتم رسم العناصر المركّبة ذات القيمة zIndex الأعلى فوق طبقات وتراكبات قيم zIndex الأقل.
iduserData
 بيانات التراكب.

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

+ (instancetype) groundOverlayWithBounds: (GMSCoordinateBounds قابل للقيم الفارغة *) الحدود
الرمز: (nullable UIImage *) 

دالة إنشاء ملائمة لـ GMSGroundOverlay لـ bounds وicon محدَّدين.

سيتم ضبط position وفقًا لذلك.

+ (instancetype) groundOverlayWithPosition: (CLLocationCoordinate2D)  الموضع
الرمز: (nullable UIImage *) 
ZoomLevel: (CGFloat) zoomLevel

تنشئ هذه الدالة GMSGroundOverlay يعرض icon المحدّد في position، كما لو كان الحجم الفعلي للصورة يتطابق مع وحدات بكسل الكاميرا في zoomLevel.


وثائق العقار

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

تمثّل هذه السمة موضع GMSGroundOverlay هذا، أو الموضع الفعلي لمرْساء الرابط.

في حال تم تغيير هذا الوضع، سيتم نقل "bounds" إلى الموضع الجديد.

- (CGPoint) علامة ارتساء [read, write, assign]

وتحدِّد علامة الارتساء مكان تثبيت GMSGroundOverlay هذا على الأرض في ما يتعلق بـ bounds.

إذا تم تعديل هذا الترتيب، سيتم ضبط position على الموضع الجديد المناسب في bounds.

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

رمز للعرض ضمن bounds على الأرض.

إذا كانت هذه القيمة فارغة، لن يكون التراكب مرئيًا (على عكس GMSMarker الذي يحتوي على صورة تلقائية).

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

يتم ضبط درجة تعتيم تراكب الأرض، بحيث يتراوح بين 0 (شفاف تمامًا) و1 (تلقائي) بشكل شامل.

- (CLLocationDirection) إتجاه [read, write, assign]

اتجاه التراكب الأرضي هذا، بالدرجات.

توجه القيمة الافتراضية "صفر" هذا التراكب الأرضي لأعلى/لأسفل على طول المحور "ص" العادي للأرض.

- (GMSCoordinateBounds*) الحدود [read, write, assign]

الحدود الثنائية الأبعاد على الأرض حيث يتم رسم icon.

سيؤدي تغيير هذه القيمة إلى تعديل position وفقًا لذلك.

- (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"، وإلا قد يتم إنشاء دورة الاحتفاظ بالبيانات (ما يؤدي إلى منع إصدار العناصر).