הפניה לכיתה ב-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 כסיווג משנה ויש ליצור אותו רק דרך ה-constructor שלו.

עוברת בירושה את GMSTileLayer.

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

(ללא)- requestTileForX:y:Zoom:Receiver:
 requestTileForX:y:Zoom:Receiver: יוצר אריחי תמונות עבור GMSTileLayer.
(ללא)- clearTileCache
 ניקוי המטמון יגרום לכך שכל המשבצות יישלחו שוב.

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

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

נכסים

NSString * userAgent
 יש לציין את סוכן המשתמש לתיאור האפליקציה.
GMSMapsView *מפה
 המפה שמוצגת ב-GMSTileLayer.
intzindex
 שכבות של משבצות עם ערך גבוה יותר של zIndex יצוינו מעל שכבות-על שלמטה של שכבות-על של zIndex.
מספר NStileSize
 ההגדרה הזאת קובעת את מספר הפיקסלים (ולא הנקודות) ש שבו יוצגו תמונות המשבצת שמוחזרות.
מספר ממשי (float)אטימות
 מציינת את השקיפות של שכבת המשבצת.
בוליאניעמעום
 מציין אם המשבצות מעומעמות.

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

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

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

בונה נוחות.

constructor לא יכול להיות אפס.

- (null) requestTileForX: (NSUInteger) x
y: (NSUInteger) שנה
זום: (NSUInteger) זום
מקלט: (id< GMSTileReceiver >) מקבל

requestTileForX:y:Zoom:Receiver: יוצר אריחי תמונות עבור GMSTileLayer.

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

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

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

- (null) clearTileCache

ניקוי המטמון יגרום לכך שכל המשבצות יישלחו שוב.


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

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


מסמכי תיעוד של הנכס

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

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

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

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

המפה שמוצגת ב-GMSTileLayer.

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

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

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

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

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

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

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

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

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

- (צף) אטימות [read, write, assign, inherited]

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

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

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

מציין אם המשבצות מעומעמות.

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