مرجع فئة 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:sharedr: ينشئ مربّعات صور لـ 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) س
تكبير/تصغير: (NSUInteger) تكبير/تصغير
المتلقي: (المعرّف< GMSTileReceiver >) المتلقّي

requestTileForX:y:zoom:sharedr: ينشئ مربّعات صور لـ 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]

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

إذا كان هذا التلميح nil (الاختيار التلقائي)، سيتم استخدام وكيل مستخدم 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) أداءً جيدًا، ولا يُنصح باستخدامها.

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

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

يحدد تعتيم طبقة التجانب.

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

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

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

الخيار التلقائي هو "نعم".