סקירה כללית
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. | |
int | zindex |
שכבות של משבצות עם ערך גבוה יותר של zIndex יצוינו מעל שכבות-על שלמטה של שכבות-על של zIndex . | |
מספר NS | tileSize |
ההגדרה הזאת קובעת את מספר הפיקסלים (ולא הנקודות) ש שבו יוצגו תמונות המשבצת שמוחזרות. | |
מספר ממשי (float) | אטימות |
מציינת את השקיפות של שכבת המשבצת. | |
בוליאני | עמעום |
מציין אם המשבצות מעומעמות. | |
פונקציות קשורות | |
(שימו לב שהפונקציות האלה אינן פונקציות חברים). | |
typedef NSURL *_Nullable(^ | GMSTileURLConstructor )(NSUInteger x, NSUInteger y, NSUInteger zoom) |
הפונקציה GMSTileURLConstructor היא בלוק שמקבל את הערכים x , y ו-zoom ומחזירה NSURL, או nil כדי לציין שאין משבצת עבור המיקום הזה. |
תיעוד פונקציות של חברים
+ (instancetype) tileLayerWithURLConstructor: | (GMSTileURLConstructor) | בונה |
בונה נוחות.
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] |
מציין אם המשבצות מעומעמות.
ברירת מחדל 'כן'.