סקירה כללית
GMSGroundOverlay מציין את האפשרויות הזמינות לשכבת-על של הקרקע הקיימת על פני כדור הארץ.
שלא כמו סמן, המיקום של שכבת-העל של הקרקע מצוין באופן מפורש והוא לא פונה למצלמה.
ההגדרה GMSOverlay עוברת בירושה.
פונקציות סטטיות של חברים ציבוריים | |
| (instancetype) | + groundOverlayWithBounds:icon: |
בנאי נוחות של GMSGroundOverlay עבור bounds ו-icon מסוימים. | |
| (instancetype) | + groundOverlayWithPosition:icon:zoomLevel: |
יוצרת GMSGroundOverlay שמעבדת את ה-icon הנתון ב-position, כאילו הגודל האמיתי של התמונה תואם לפיקסלים של המצלמה ב-zoomLevel. | |
נכסים | |
| ניהול צוותים ב-CLLocation2D | מיקום |
| המיקום של ה-GMSGroundOverlay, או באופן ספציפי יותר, המיקום הפיזי של העוגן שלו. | |
| CGPoint | עוגן |
העוגן מציין היכן GMSGroundOverlay מעוגנת לכדור הארץ ביחס ל-bounds. | |
| UIImage * | סמל |
סמל לעיבוד בתוך bounds על-גבי כדור הארץ. | |
| float | שקיפות |
| מגדיר את האטימות של שכבת-העל של הקרקע, בין 0 (שקוף לחלוטין) ל-1 (ברירת מחדל) כולל. | |
| CLLocationDirection | נושא |
| הנושא של שכבת-העל היבשתית, במעלות. | |
| GMSCoordinateBounds * | גבולות |
הגבולות הדו-ממדיים על כדור הארץ שבו משורטט icon. | |
| NSString * | שם הפריט |
| כותרת, תיאור קצר של שכבת-העל. | |
| GMSMapView * | מפה |
| המפה שבה מוצגת שכבת-העל. | |
| בול (BOOL) | tappable |
| אם שכבת-העל הזו אמורה לגרום להתראות על הקשה. | |
| int | zIndex |
שכבות-על של ערך zIndex גבוה יותר ישורטטו מעל לשכבות-על ושכבות-על של משבצות של ערכי zIndex. | |
| id [מזהה] | userData |
| נתוני שכבות-על. | |
תיעוד לגבי פונקציות חברים
| + (instancetype) groundOverlayWithBounds: | (null_GMSCoordinateBounds *) | גבולות | |
| סמל: | (nullable UIImage *) | סמל | |
בנאי נוחות של GMSGroundOverlay עבור bounds ו-icon מסוימים.
יגדיר את position בהתאם.
| + (instancetype) groundOverlayWithPosition: | (CLLocationCoordinate2D) | מיקום | |
| סמל: | (nullable UIImage *) | סמל | |
| רמת הזום: | (CGFloat) | zoomLevel | |
יוצרת GMSGroundOverlay שמעבדת את ה-icon הנתון ב-position, כאילו הגודל האמיתי של התמונה תואם לפיקסלים של המצלמה ב-zoomLevel.
מסמכי תיעוד לגבי הנכס
- (CLLocationcoordinate2D) position [read, write, assign] |
המיקום של ה-GMSGroundOverlay, או באופן ספציפי יותר, המיקום הפיזי של העוגן שלו.
אם מיקום זה ישתנה, המערכת של bounds תעבור למיקום החדש.
- (CGPoint) anchor [read, write, assign] |
העוגן מציין היכן GMSGroundOverlay מעוגנת לכדור הארץ ביחס ל-bounds.
אם זה ישתנה, position יוגדר למיקום החדש המתאים בתוך bounds.
- (UIImage*) icon [read, write, assign] |
סמל לעיבוד בתוך bounds על-גבי כדור הארץ.
אם המספר הוא אפס, שכבת-העל לא תהיה גלויה (בניגוד ל-GMSMarker, שכולל תמונת ברירת מחדל).
- שקיפות [read, write, assign] (צף) |
מגדיר את האטימות של שכבת-העל של הקרקע, בין 0 (שקוף לחלוטין) ל-1 (ברירת מחדל) כולל.
- (CLLocationDirection) נושא [read, write, assign] |
הנושא של שכבת-העל היבשתית, במעלות.
ערך ברירת המחדל, אפס, מצביע על שכבת-העל הקרקעית הזו למעלה/למטה לאורך ציר ה-Y הרגיל של כדור הארץ.
- (GMSCoordinateBounds*) גבולות [read, write, assign] |
הגבולות הדו-ממדיים על כדור הארץ שבו משורטט icon.
שינוי הערך הזה ישנה את position בהתאם.
- (NSString*) title [read, write, copy, inherited] |
כותרת, תיאור קצר של שכבת-העל.
שכבות-על מסוימות, כגון סמנים, יציגו את הכותרת במפה. הכותרת היא גם טקסט ברירת המחדל לנגישות.
- (GMSMapView*) מפה [read, write, assign, inherited] |
המפה שבה מוצגת שכבת-העל.
הגדרת המאפיין הזה תוסיף את שכבת-העל למפה. הגדרת הערך אפס תגרום להסרת שכבת-העל הזו מהמפה. שכבת-על יכולה להיות פעילה במפה אחת לכל היותר בכל זמן נתון.
- (BOOL) ניתן להקיש [read, write, assign, inherited] |
אם שכבת-העל הזו אמורה לגרום להתראות על הקשה.
שכבות-על מסוימות, כמו סמנים, יוגדרו כברירת מחדל כניתנות להקשה.
- (int) zIndex [read, write, assign, inherited] |
שכבות-על של ערך zIndex גבוה יותר ישורטטו מעל לשכבות-על ושכבות-על של משבצות של ערכי zIndex.
ערכים שווים מובילים לסדר שרטוט לא מוגדר. סמנים הם יוצאי דופן לכך שבלי קשר ל-zIndex, הם תמיד יצוירו מעל שכבות אריחים ושכבות-על אחרות שאינן סמנים; למעשה הם נחשבים בפועל לקבוצה נפרדת של אינדקס z בהשוואה לשכבות-על אחרות.
- (id) userData [read, write, assign, inherited] |
נתוני שכבות-על.
ניתן להשתמש במאפיין הזה כדי לשייך אובייקט שרירותי לשכבת-העל הזו. ה-SDK של מפות Google ל-iOS לא קורא או כותב את הנכס הזה.
הערה: אסור שיהיו ב-userData הפניות חזקות לאובייקטים של מפות Google, אחרת יכול להיווצר מחזור שמירה (מונע שחרור של אובייקטים).