نظرة عامة
يجلب 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] |
تحدِّد هذه السياسة ما إذا كان يجب أن تتلاشى المربّعات.
الخيار التلقائي هو "نعم".