הפניה למחלקה 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 שקיפות
 מציין את השקיפות של שכבת המשבצת.
בוליאניfadeIn
 מציינת אם המשבצות צריכות להתעמעם.

(שימו לב: אלו אינן פונקציות חבר).

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

מסמכי תיעוד לגבי פונקציות של חברים

הכלי לבניית נוחות.

constructor חייב להיות לא אפס.

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

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

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

יש לציין kGMSTileLayerNoTile אם אין אריח זמין עבור מיקום זה, או להזין nil אם אירעה שגיאה זמנית וייתכן שכרטיס מידע יהיה זמין בשלב מאוחר יותר.

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

- (ריק) clearTileCache

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


- (typedef NSURL* _Nullable(^ GMSTileURLConstructor)(NSUInteger x, NSUInteger y, שינוי מרחק התצוגה של NSUInteger)) [related]

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


תיעוד נכס

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

צריך לציין את סוכן המשתמש לתיאור האפליקציה.

אם הערך הוא nil (ברירת המחדל), סוכן המשתמש ל-iOS שמוגדר כברירת מחדל ישמש לבקשות HTTP.

- (GMSMapView*) מפה [read, write, assign, inherited]

המפה שבה מוצג ה-GMSTileOverlay הזה.

הגדרת המאפיין הזה תוסיף את השכבה למפה. הגדרת הערך nil תסיר את השכבה הזו מהמפה. שכבה יכולה להיות פעילה במפה אחת לכל היותר בכל זמן נתון.

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

שכבות משבצות גבוהות יותר של ערך zIndex ישורטטו מעל לשכבות-על ושכבות-על של אריחים עם ערך zIndex.

ערכים שווים מובילים לסדר שרטוט לא מוגדר.

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

ההגדרה קובעת את מספר הפיקסלים (לא נקודות) שבהם תמונות המשבצת שהוחזרו יעדיפו להציג.

לקבלת התוצאות הטובות ביותר, מומלץ לציין את אורך הקצה של המשבצות המותאמות אישית. ברירת המחדל היא 256, שהוא הגודל המסורתי של קטעי המפה של מפות Google.

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

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

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

מציין את השקיפות של שכבת המשבצת.

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

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

מציינת אם המשבצות צריכות להתעמעם.

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