סקירה כללית
GMSTileLayer הוא מחלקה מופשטת שמאפשרת ליצור שכבת-על של משבצות תמונה מותאמות אישית ב-GMSMapView ספציפי.
ייתכן שהוא לא יופעל באופן ישיר, ומחלקות משנה חייבות להטמיע את השיטה TileForX:y:zoom: כדי להחזיר אריחים.
ברמת זום 0, כל העולם הוא ריבוע מכוסה באריח אחד, והקואורדינטות x ו-y הן 0 עבור אריח זה. בזום 1 ברמה 1, העולם מכוסה ב-4 אריחים כאשר x ו-y הם 0 או 1, וכן הלאה.
עוברת בירושה על ידי GMSSyncTileLayer ו-GMSURLTileLayer.
פונקציות של חברי ציבור | |
| (void) | - requestTileForX:y:zoom:receiver: |
| requestTileForX:y:zoom:receiver: יוצר אריחי תמונות עבור GMSTileOverlay. | |
| (void) | – clearTileCache |
| מנקה את המטמון כדי לבקש שוב את כל המשבצות. | |
נכסים | |
| GMSMapView * | מפה |
| המפה שבה מוצג ה-GMSTileOverlay. | |
| int | zIndex |
שכבות משבצת גבוהות יותר של zIndex ישורטטו על-פני שכבות-על ושכבות-על של משבצות ערך נמוכות יותר של zIndex. | |
| NSInteger | tileSize |
| מציינת את מספר הפיקסלים (לא הנקודות) שתמונות המשבצת שהוחזרו יעדיף להציג. | |
| float | שקיפות |
| המדיניות קובעת את מידת השקיפות של שכבת המשבצת. | |
| בול (BOOL) | fadeIn |
| מציינת אם המשבצות ישתלבו בהדרגה. | |
תיעוד לגבי פונקציות חברים
| - (void) requestTileForX: | (NSUInteger) | x | |
| y: | (NSUInteger) | שנה | |
| זום: | (NSUInteger) | שינוי מרחק התצוגה | |
| מקבל: | (id< GMSTileReceiver >) | הנמען | |
requestTileForX:y:zoom:receiver: יוצר אריחי תמונות עבור GMSTileOverlay.
מחלקות משנה צריכות לבטל אותו. כרטיס המידע של x, של y ושל zoom _חייב_ להיות מועבר מאוחר יותר אל receiver.
יש לציין kGMSTileLayerNoTile אם אין אריח זמין עבור מיקום זה; או להזין אפס אם אירעה שגיאה זמנית וייתכן שמשבצת מסוימת תהיה זמינה מאוחר יותר.
קריאות לשיטה הזו יבוצעו ב-thread הראשי. ב-GMSSyncTileLayer מופיע מידע על מחלקת בסיס שמטמיעה שכבת משבצות חוסמת שלא פועלת ב-thread הראשי של האפליקציה.
| - (ריק) clearTileCache |
מנקה את המטמון כדי לבקש שוב את כל המשבצות.
מסמכי תיעוד לגבי הנכס
- (GMSMapView*) מפה [read, write, assign] |
המפה שבה מוצג ה-GMSTileOverlay.
הגדרת המאפיין הזה תוסיף את השכבה למפה. הגדרת הערך אפס תגרום להסרת השכבה הזו מהמפה. בכל זמן נתון, שכבה יכולה להיות פעילה במפה אחת לכל היותר.
- (int) zIndex [read, write, assign] |
שכבות משבצת גבוהות יותר של zIndex ישורטטו על-פני שכבות-על ושכבות-על של משבצות ערך נמוכות יותר של zIndex.
ערכים שווים מובילים לסדר שרטוט לא מוגדר.
- (NSInteger) tileSize [read, write, assign] |
מציינת את מספר הפיקסלים (לא הנקודות) שתמונות המשבצת שהוחזרו יעדיף להציג.
לקבלת התוצאות הטובות ביותר, מומלץ לקבוע את אורך הקצה של המשבצות המותאמות אישית. ברירת המחדל היא 256, שהוא הגודל המסורתי של משבצות של מפות Google.
ייתכן שערכים נמוכים מ-128 נקודות (למשל, 256 פיקסלים במכשירי רטינה) לא יניבו ביצועים טובים ולא מומלץ להשתמש בהם.
לדוגמה, ייתכן שמפתח אפליקציות ירצה לספק אריחי רשתית (אורך קצה של 512 פיקסלים) במכשירים עם מסך רטינה, כדי לשמור על אותו מספר משבצות בכל צפייה כמו ערך ברירת המחדל של 256 שיתקבל במכשירים שאינם משבצות.
- שקיפות [read, write, assign] (צף) |
המדיניות קובעת את מידת השקיפות של שכבת המשבצת.
הפעולה הזו מספקת מכפיל לערוץ האלפא של תמונות משבצת.
- (BOOL) fadeIn [read, write, assign] |
מציינת אם המשבצות ישתלבו בהדרגה.
ברירת המחדל היא 'כן'.