סקירה כללית
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: יוצרת משבצות תמונה ל-GMSTileOverlay. | |
(מבוטל) | – clearTileCache |
מנקה את המטמון כך שבקשות נוספות של כל המשבצות יישלחו. | |
פונקציות סטטיות של חברים ציבוריים | |
(instancetype) | + tileLayerWithURLConstructor: |
בנאי נוחות. | |
מאפיינים | |
NSString * | userAgent |
מציינים את סוכן המשתמש שמתאר את האפליקציה. | |
GMSMapView * | מפה |
המפה שבה מוצגת GMSTileOverlay הזו. | |
INT | zIndex |
שכבות משבצת עם ערך גבוה יותר של zIndex ייציירו מעל שכבות-על ושכבות-על של משבצות עם ערך zIndex נמוך יותר. | |
NSInteger | tileSize |
מציין את מספר הפיקסלים (לא הנקודות) שתמונות המשבצת שהוחזרו יעדיפו להציג. | |
מספר ממשי (float) | אטימוּת |
מציינת את האטימות של שכבת המשבצות. | |
בוליאני | fadeIn |
ההגדרה קובעת אם המשבצות עמעום הדרגתי. | |
פונקציות קשורות | |
(שימו לב: אלו אינן פונקציות חבר). | |
typedef NSURL *_Nullable(^ | GMSTileURLConstructor )(NSUInteger x, NSUInteger y, NSUInteger Zoom) |
GMSTileURLConstructor הוא בלוק שמקבל את x , y ו-zoom ומחזיר NSURL, או nil כדי לציין שאין משבצת למיקום הזה. |
מסמכי תיעוד בנושא פונקציות של חברים
+ (instancetype) tileLayerWithURLConstructor: | (GMSTileURLConstructor) | constructor |
בנאי נוחות.
הערך constructor
חייב להיות לא אפס.
- (מבוטל) requestTileForX: | (NSUInteger) | x | |
y: | (NSUInteger) | שנה | |
שינוי מרחק התצוגה: | (NSUInteger) | שינוי מרחק התצוגה | |
מקלט: | (id< GMSTileReceiver >) | מקלט | |
requestTileForX:y:Zoom:Receiver: יוצרת משבצות תמונה ל-GMSTileOverlay.
צריך לבטל אותו במחלקות משנה. האריח של x
, y
ו-zoom
_חייבים להיות מועברים מאוחר יותר אל receiver
.
לציין kGMSTileLayerNoTile אם אין משבצת זמינה עבור המיקום הזה. או nil אם אירעה שגיאה זמנית וייתכן שמשבצת מסוימת תהיה זמינה מאוחר יותר.
קריאות לשיטה הזו יבוצעו ב-thread הראשי. ראו GMSSyncTileLayer למחלקה הבסיסית שמממשת שכבה של משבצת חסימה שלא פועלת ב-thread הראשי של האפליקציה.
- (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.
- (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 במכשיר שאינו רטינה.
- (צף) אטימוּת [read, write, assign, inherited] |
מציינת את האטימות של שכבת המשבצות.
כך מתקבל מכפיל לערוץ האלפא של תמונות משבצת.
- (BOOL) fadeIn [read, write, assign, inherited] |
ההגדרה קובעת אם המשבצות עמעום הדרגתי.
ברירת המחדל היא 'כן'.