הפניה למחלקה 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:receiver: יוצר אריחי תמונות עבור GMSTileOverlay.
(void) clearTileCache
 מנקה את המטמון כדי לבקש שוב את כל המשבצות.

פונקציות סטטיות של חברים ציבוריים

(instancetype)+ tileLayerWithURLConstructor:
 בנאי נוחות.

נכסים

NSString * userAgent
 יש לציין את סוכן המשתמש לתיאור האפליקציה.
GMSMapViewמפה
 המפה שבה מוצג ה-GMSTileOverlay.
int zIndex
 שכבות משבצת גבוהות יותר של zIndex ישורטטו על-פני שכבות-על ושכבות-על של משבצות ערך נמוכות יותר של zIndex.
NSIntegertileSize
 מציינת את מספר הפיקסלים (לא הנקודות) שתמונות המשבצת שהוחזרו יעדיף להציג.
float שקיפות
 המדיניות קובעת את מידת השקיפות של שכבת המשבצת.
בול (BOOL)fadeIn
 מציינת אם המשבצות ישתלבו בהדרגה.

(חשוב לזכור שאלה לא פונקציות חבר).

typedef NSURL *_Nullable(^ GMSTileURLConstructor )(NSUInteger x, NSUInteger y, NSUInteger זום)
 GMSTileURLConstructor הוא בלוק שלוקח את x, y ו-zoom ומחזיר NSURL, או אפס כדי לציין שאין משבצת עבור המיקום הזה.

תיעוד לגבי פונקציות חברים

+ (instancetype) tileLayerWithURLConstructor: (GMSTileURLConstructor) constructor

בנאי נוחות.

הערך של constructor חייב להיות לא אפס.

- (void) requestTileForX: (NSUInteger) x
y: (NSUInteger) שנה
זום: (NSUInteger) שינוי מרחק התצוגה
מקבל: (id< GMSTileReceiver >) הנמען

requestTileForX:y:zoom:receiver: יוצר אריחי תמונות עבור GMSTileOverlay.

מחלקות משנה צריכות לבטל אותו. כרטיס המידע של x, של y ושל zoom _חייב_ להיות מועבר מאוחר יותר אל receiver.

יש לציין kGMSTileLayerNoTile אם אין אריח זמין עבור מיקום זה; או להזין אפס אם אירעה שגיאה זמנית וייתכן שמשבצת מסוימת תהיה זמינה מאוחר יותר.

קריאות לשיטה הזו יבוצעו ב-thread הראשי. ב-GMSSyncTileLayer מופיע מידע על מחלקת בסיס שמטמיעה שכבת משבצות חוסמת שלא פועלת ב-thread הראשי של האפליקציה.

- (ריק) clearTileCache

מנקה את המטמון כדי לבקש שוב את כל המשבצות.


- (typedef NSURL* _Nullable(^ GMSTileURLConstructor)(NSUInteger x, NSUInteger y, מרחק התצוגה של NSUInteger)) [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 פיקסלים במכשירי רטינה) לא יניבו ביצועים טובים ולא מומלץ להשתמש בהם.

לדוגמה, ייתכן שמפתח אפליקציות ירצה לספק אריחי רשתית (אורך קצה של 512 פיקסלים) במכשירים עם מסך רטינה, כדי לשמור על אותו מספר משבצות בכל צפייה כמו ערך ברירת המחדל של 256 שיתקבל במכשירים שאינם משבצות.

- שקיפות [read, write, assign, inherited] (צף)

המדיניות קובעת את מידת השקיפות של שכבת המשבצת.

הפעולה הזו מספקת מכפיל לערוץ האלפא של תמונות משבצת.

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

מציינת אם המשבצות ישתלבו בהדרגה.

ברירת המחדל היא 'כן'.