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