مرجع فئة GMSURLTileLayer


نظرة عامة

يجلب GMSURLTileProvider المربّعات استنادًا إلى عناوين URL المعروضة من دالة GMSTileURLConstructor.

مثلاً:

   GMSTileURLConstructor constructor = ^(NSUInteger x, NSUInteger y, NSUInteger zoom) {
     NSString *URLStr =
         [NSString stringWithFormat:"https://example.com/%d/%d/%d.png", x, y, zoom];
     return [NSURL URLWithString:URLStr];
   };
   GMSTileLayer *layer =
       [GMSURLTileLayer tileLayerWithURLConstructor:constructor];
   layer.userAgent = "SDK user agent";
   layer.map = map;
 

لا يمكن تصنيف GMSURLTileProvider ضمن فئة فرعية ويجب إنشاؤه فقط من خلال الدالة الإنشائية الملائمة.

يكتسب GMSTileLayer.

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

(void) - requestTileForX:y:zoom:receiver:
 requestTileForX:y:zoom:receivedr: ينشئ أقسام صور لـ GMSTileOverlay.
(void) - clearTileCache
 يتم محو ذاكرة التخزين المؤقت بحيث يتم طلب جميع المربّعات مرة أخرى.

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

(instancetype)+ tileLayerWithURLConstructor:
 دالة إنشاء سهولة الاستخدام.

المواقع

NSString * userAgent
 حدِّد وكيل المستخدم لوصف تطبيقك.
GMSMapViewخريطة
 الخريطة التي يتم عرض GMSTileOverlay عليها.
int zIndex
 سيتم رسم طبقات تجانب ذات قيمة أعلى في zIndex فوق طبقات التجانب والتراكبات ذات قيمة zIndex الأقل.
عدد صحيحtileSize
 يُحدِّد عدد وحدات البكسل (وليس النقاط) التي تفضِّل أن تظهر بها صور المربّعات التي يتم عرضها.
float معدل الشفافية
 يُحدِّد درجة تعتيم طبقة المربّع.
قيمة منطقيةfadeIn
 تحدِّد هذه السياسة ما إذا كان يجب أن تتلاشى المربّعات.

(يُرجى العلم أنّ هذه الدوال ليست أعضاء.)

typedef NSURL *_Nullable(^ GMSTileURLConstructor )(NSUInteger x, NSUInteger y, NSUInteger Zoom)
 GMSTileURLConstructor هو قالب يستخدم x وy وzoom ويعرض NSURL، أو صفر للإشارة إلى عدم وجود مربع لذلك الموقع.

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

+ (instancetype) tileLayerWithURLConstructor: (GMSTileURLConstructor) دالة إنشائية

دالة إنشاء سهولة الاستخدام.

يجب أن تكون قيمة constructor فارغة.

- (إبطال) requestTileForX: (NSUInteger) x
ص: (NSUInteger) y
تكبير/تصغير: (NSUInteger) تكبير/تصغير
المتلقي: (id< GMSTileReceiver >) المستلِم

requestTileForX:y:zoom:receivedr: ينشئ أقسام صور لـ GMSTileOverlay.

يجب أن تلغي الفئات الفرعية هذا التصنيف. _يجب_ تمرير مربّع الاختيار الخاص بـ x وy وzoom إلى receiver لاحقًا.

حدِّد kGMSTileLayerNoTile إذا لم يكن هناك مربّع متاح لهذا الموقع الجغرافي، أو لا قيمة في حال حدوث خطأ عابر وقد يتم توفير مربّع لاحقًا.

سيتم إجراء الطلبات المرتبطة بهذه الطريقة في سلسلة التعليمات الرئيسية. راجِع GMSSyncTileLayer لمعرفة الفئة الأساسية التي تنفِّذ طبقة تجانب حظر لا تعمل على سلسلة التعليمات الرئيسية لتطبيقك.

- (إبطال) clearTileCache

يتم محو ذاكرة التخزين المؤقت بحيث يتم طلب جميع المربّعات مرة أخرى.


- (typedef NSURL* _Nullable(^ GMSTileURLConstructor)(NSUInteger x, NSUInteger y, NSUInteger Zoom)) [related]

GMSTileURLConstructor هو قالب يستخدم x وy وzoom ويعرض NSURL، أو صفر للإشارة إلى عدم وجود مربع لذلك الموقع.


وثائق العقارات

- (NSString*) userAgent [read, write, copy]

حدِّد وكيل المستخدم لوصف تطبيقك.

وإذا كان هذا الحقل لا يحتوي على أي قيمة (الإعداد التلقائي)، سيتم استخدام وكيل مستخدم iOS التلقائي لطلبات HTTP.

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

الخريطة التي يتم عرض GMSTileOverlay عليها.

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

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

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

ينتج عن القيم المتساوية ترتيب رسم غير محدّد.

- (NSInteger) tileSize [read, write, assign, inherited]

يُحدِّد عدد وحدات البكسل (وليس النقاط) التي تفضِّل أن تظهر بها صور المربّعات التي يتم عرضها.

للحصول على أفضل النتائج، يجب أن يكون هذا هو طول حافة المربّعات المخصّصة. يتم الوضع التلقائي على القيمة 256، وهو الحجم التقليدي لمربّعات خرائط Google.

القيم الأقل من ما يعادل 128 نقطة (مثلاً 256 بكسل على الأجهزة المزوّدة بشاشة Retina) قد لا تحقّق أداءً جيدًا ولا يُنصح باستخدامها.

ومثال على ذلك، قد يرغب أحد مطوري التطبيقات في توفير شاشات Retina (طول حافة 512 بكسل) في الأجهزة المزوّدة بشاشة Retina، وذلك للحفاظ على عدد المربّعات لكل عرض كما هو الحال في القيمة التلقائية التي تبلغ 256 إطارًا على أي جهاز لا تشتمل على شبكات ريتينا.

- معدل الشفافية (عائم) [read, write, assign, inherited]

يُحدِّد درجة تعتيم طبقة المربّع.

يوفر هذا مضاعفًا لقناة ألفا لصور التجانب.

- (BOOL) fadeIn [read, write, assign, inherited]

تحدِّد هذه السياسة ما إذا كان يجب أن تتلاشى المربّعات.

الإعداد التلقائي "نعم".