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