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