סקירה כללית
סמן הוא סמל שמוצב בנקודה מסוימת על פני השטח של המפה.
סמל של סמן מצויר ביחס למסך המכשיר ולא לפני השטח של המפה. כלומר, כיוון הסמל לא בהכרח ישנה את הכיוון עקב סיבובים של המפה, הטיה או שינוי מרחק התצוגה.
ההגדרה GMSOverlay עוברת בירושה.
הועברה בירושה על ידי GMSAdvancedMarker.
פונקציות סטטיות של חברים ציבוריים | |
| (instancetype) | + markerWithPosition: |
| בנאי נוחות של סמן ברירת מחדל. | |
| (UIImage *) | + markImageWithColor: |
| יוצרת גרסה בגוונים של תמונת הסמן שמוגדרת כברירת מחדל לשימוש כסמל. | |
נכסים | |
| ניהול צוותים ב-CLLocation2D | מיקום |
| מיקום הסמן. | |
| NSString * | קטע טקסט |
| טקסט של קטע טקסט, מוצג מתחת לכותרת בחלון המידע כאשר הוא נבחר. | |
| UIImage * | סמל |
| סמל הסמן לעיבוד. | |
| UIView * | iconView |
| תצוגת הסמן לעיבוד. | |
| בול (BOOL) | tracksViewChanges |
| קובעת אם יש לצייר מחדש את הסמל של הסמן הזה בכל מסגרת. | |
| בול (BOOL) | tracksInfoWindowChanges |
| קובע אם יש לצייר מחדש את חלון המידע של סמן זה בכל מסגרת. | |
| CGPoint | groundAnchor |
| עוגן קרקע מציין את הנקודה בתמונת הסמל שמעוגנת למיקום הסמן על פני כדור הארץ. | |
| CGPoint | infoWindowAnchor |
| העוגן של חלון המידע מציין את הנקודה בתמונת הסמל שבה יש לעגן את חלון המידע, שתוצג ישירות מעל נקודה זו. | |
| GMSMarkerAnimation | appearAnimation |
| שולטת באנימציה שנעשה בה שימוש כשהסמן הזה ממוקם ב-GMSMapView (ברירת המחדל kGMSMarkerAnimationNone, ללא אנימציה). | |
| בול (BOOL) | ניתן לגרירה |
| קובע אם ניתן לגרור את הסמן הזה באופן אינטראקטיבי (ברירת המחדל היא 'לא'). | |
| בול (BOOL) | שטוח |
| קובע אם הסמן צריך להיות שטוח על פני השטח של כדור הארץ (YES) או לוח מודעות שפונה למצלמה (NO, ברירת מחדל). | |
| CLLocationDegrees | סבב |
| מגדיר את סיבוב הסמן במעלות בכיוון השעון סביב נקודת העוגן של הסמן. | |
| float | שקיפות |
| מגדיר את שקיפות הסמן, בין 0 (שקוף לחלוטין) ל-1 (ברירת מחדל) כולל. | |
| GMSMarkerLayer * | שכבה |
| מספקת את שכבת האנימציה העיקרית עבור ה-GMSMarker הזה. | |
| GMSPanoramaView * | panoramaView |
panoramaView מציין איזו תצוגת פנורמה תנסה להציג את הסמן הזה. | |
| NSString * | שם הפריט |
| כותרת, תיאור קצר של שכבת-העל. | |
| GMSMapView * | מפה |
| המפה שבה מוצגת שכבת-העל. | |
| בול (BOOL) | tappable |
| אם שכבת-העל הזו אמורה לגרום להתראות על הקשה. | |
| int | zIndex |
שכבות-על של ערך zIndex גבוה יותר ישורטטו מעל לשכבות-על ושכבות-על של משבצות של ערכי zIndex. | |
| id [מזהה] | userData |
| נתוני שכבות-על. | |
תיעוד לגבי פונקציות חברים
| + (instancetype) markerWithPosition: | (CLLocationCoordinate2D) | מיקום |
בנאי נוחות של סמן ברירת מחדל.
| + (UIImage *) markImageWithColor: | (nullable UIColor *) | צבע [color] |
יוצרת גרסה בגוונים של תמונת הסמן שמוגדרת כברירת מחדל לשימוש כסמל.
מסמכי תיעוד לגבי הנכס
- (CLLocationcoordinate2D) position [read, write, assign] |
מיקום הסמן.
מונפש.
- (NSString*) snippet [read, write, copy] |
טקסט של קטע טקסט, מוצג מתחת לכותרת בחלון המידע כאשר הוא נבחר.
- (UIImage*) icon [read, write, assign] |
סמל הסמן לעיבוד.
אם השדה יישאר אפס, המערכת תשתמש בסמן מיקום של ה-SDK שמוגדר כברירת מחדל.
תמיכה בתמונות מונפשות, אך כל מסגרת חייבת להיות באותו גודל או שהתנהגות המערכת לא מוגדרת.
תומך בשימוש ביישורRectInsets כדי לציין אזור הקשה מצומצם. ההגדרה הזו גם מגדירה מחדש את אופן ציון העוגנים. בתמונה מונפשת נעשה שימוש בערך של האנימציה, ולא בפריימים הבודדים.
- (UIView*) iconView [read, write, assign] |
תצוגת הסמן לעיבוד.
אם משאירים את הערך אפס, הפונקציה מחזירה במקום זאת את המאפיין icon.
תומכת באנימציה של כל מאפייני האנימציה של UIView, מלבד frame ו-center. אין תמיכה בשינוי המאפיינים האלה או בגרסת ה-CALayer שלהם, כולל position.
חשוב לשים לב שהתצוגה מתנהגת כאילו ההגדרה של clipsToBounds היא 'כן', ללא קשר לערך שלה בפועל.
- (BOOL) tracksViewChanges [read, write, assign] |
קובעת אם יש לצייר מחדש את הסמל של הסמן הזה בכל מסגרת.
חשוב לשים לב שכאשר ההגדרה משתנה מ'לא' ל'כן', אין ספק שהסמל ייראה מחדש בפריים הבא.
ברירת המחדל היא YES. אין השפעה אם הערך של iconView הוא אפס.
- (BOOL) tracksInfoWindowChanges [read, write, assign] |
קובע אם יש לצייר מחדש את חלון המידע של סמן זה בכל מסגרת.
חשוב לשים לב שכאשר ההגדרה משתנה מ'לא' ל'כן', מובטח שחלון המידע יצורף מחדש למסגרת הבאה.
ברירת המחדל היא NO.
- (CGPoint) groundAnchor [read, write, assign] |
עוגן קרקע מציין את הנקודה בתמונת הסמל שמעוגנת למיקום הסמן על פני כדור הארץ.
הנקודה הזו מצוינת בשטח הרציף [0.0, 1.0] x [0.0, 1.0], כאשר (0,0) היא הפינה השמאלית העליונה של התמונה ו-(1,1) היא הפינה הימנית התחתונה.
אם בתמונה יש יישור שאינו אפסRectInsets, הפינה השמאלית העליונה והימנית התחתונה שהוזכרו למעלה מתייחסות לקטע שבתמונה.
- (CGPoint) infoWindowAnchor [read, write, assign] |
העוגן של חלון המידע מציין את הנקודה בתמונת הסמל שבה יש לעגן את חלון המידע, שתוצג ישירות מעל נקודה זו.
הנקודה הזו מצוינת באותו שטח כמו 'עוגן קרקע'.
- (GMSMarkerAnimation) appearAnimation [read, write, assign] |
שולטת באנימציה שנעשה בה שימוש כשהסמן הזה ממוקם ב-GMSMapView (ברירת המחדל kGMSMarkerAnimationNone, ללא אנימציה).
- (BOOL) ניתן לגרירה [read, write, assign] |
קובע אם ניתן לגרור את הסמן הזה באופן אינטראקטיבי (ברירת המחדל היא 'לא').
- (BOOL) דירה [read, write, assign] |
קובע אם הסמן צריך להיות שטוח על פני השטח של כדור הארץ (YES) או לוח מודעות שפונה למצלמה (NO, ברירת מחדל).
- (CLLocationDegrees) רוטציה [read, write, assign] |
מגדיר את סיבוב הסמן במעלות בכיוון השעון סביב נקודת העוגן של הסמן.
ציר הסיבוב מאונך לסמן. סיבוב של 0 תואם למיקום ברירת המחדל של הסמן. מונפש.
כאשר הסמן שטוח במפה, המיקום המוגדר כברירת מחדל מיושר לכיוון צפון והסיבוב הוא כך שהסמן תמיד נשאר שטוח על המפה. כאשר הסמן הוא לוח מודעות, מיקום ברירת המחדל פונה כלפי מעלה והסיבוב הוא כך שהסמן תמיד פונה למצלמה.
- שקיפות [read, write, assign] (צף) |
מגדיר את שקיפות הסמן, בין 0 (שקוף לחלוטין) ל-1 (ברירת מחדל) כולל.
- (GMSMarkerLayer*) שכבה [read, assign] |
מספקת את שכבת האנימציה העיקרית עבור ה-GMSMarker הזה.
- (GMSPanoramaView*) panoramaView [read, write, assign] |
panoramaView מציין איזו תצוגת פנורמה תנסה להציג את הסמן הזה.
לתשומת ליבך, אם ה-position של הסמן רחוק מדי מהמיקום הפנורמי הנוכחי של panoramaView, הוא לא יוצג כיוון שהוא קטן מדי.
ניתן לקבוע לערך אפס כדי להסיר את הסמן מכל תצוגה פנורמית נוכחית שהוא מצורף אליה.
ניתן להציג סמן גם בפנורמה וגם במפה בו-זמנית.
- (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, אחרת יכול להיווצר מחזור שמירה (מונע שחרור של אובייקטים).