סקירה
זוהי המחלקה העיקרית של ה-SDK של מפות Google ל-iOS, והיא נקודת הכניסה לכל השיטות שקשורות למפה.
יש ליצור את המפה באמצעות אחד מהבנאים -init או -initWithOptions:.
אפשר לקרוא ולשנות את GMSMapView רק מה-thread הראשי, בדומה לכל האובייקטים של UIKit. קריאה ל-methods משרשור אחר תוביל לחריגת או להתנהגות לא מוגדרת.
פונקציות של חברים ציבוריים | |
| (instancetype) | – init |
| אתחול ב-CGRectZero ואפשרויות ברירת מחדל. | |
| (instancetype) | - initWithOptions: |
| יצירה של תצוגת מפה חדשה עם האפשרויות הנתונות. | |
| (instancetype) | - initWithFrame: |
| (סוג מופע שיכול להיות null) | – initWithCoder: |
| (instancetype) | - initWithFrame:camera: |
| יוצרת ומחזירה תצוגת מפה עם פריים ויעד מצלמה. | |
| (instancetype) | - initWithFrame:mapID:camera: |
| יוצר ומחזיר תצוגת מפה עם מסגרת, מזהה מפה ויעד מצלמה. | |
| (void) | – startRendering |
| מנחה את המפה הזו כדי לשפר את כלי הרינדור. | |
| (void) | – stopRendering |
| מורה למפה הזו לכבות את כלי הרינדור. | |
| (void) | - נקי |
| ניקוי כל תגי העיצוב שנוספו למפה, כולל סמנים, קווים פוליגוניים ושכבות-על של קרקע. | |
| (void) | – setMinZoom:maxZoom: |
הגדרה של minZoom ו-maxZoom. | |
| (nullable GMSCameraPosition *) | - cameraForBounds:insets: |
בונים GMSCameraPosition שמציג את bounds עם padding. | |
| (void) | - moveמצלמה: |
החלפת המצלמה בהתאם ל-update. | |
| (BOOL) | – areEqualForRenderingPosition:position: |
| בדקו אם מיקומי המצלמה הנתונים יגרמו בפועל להצגת המצלמה באותו אופן, תוך התחשבות ברמת הדיוק והטרנספורמציות בשימוש פנימי. | |
| (GMSFeatureLayer < GMSPlaceFeature * > *) | - featureLayerOfFeatureType: |
| מחזירה שכבה של תכונה מהסוג שצוין. | |
| (GMSDatasetFeatureLayer *) | – datasetFeatureLayerOfDatasetID: |
| מחזירה שכבה של מאפיין מערך הנתונים של מערך הנתונים שצוין. | |
| (void) | – animateTo CameraPosition: |
הוספת אנימציה של המצלמה של המפה הזו ל-cameraPosition. | |
| (void) | - animateToLocation: |
כ-animateTo CameraPosition:, אבל משנה רק את מיקום המצלמה (כלומר, מהמיקום הנוכחי ל-location). | |
| (void) | – animateToZoom: |
| כ-animateTocameraPosition:, אבל משנה רק את רמת הזום של המצלמה. | |
| (void) | – animateToBearing: |
| כ-animateTo CameraPosition: אבל משנה רק את כיוון המצלמה (במעלות). | |
| (void) | – animateToViewAngle: |
| כ-animateTo CameraPosition: אבל משנה רק את זווית הצפייה של המצלמה (במעלות). | |
| (void) | – animateWith CameraUpdate: |
המערכת מחילה את cameraUpdate על המצלמה הנוכחית, ולאחר מכן משתמשת בתוצאה בהתאם ל-animateTocameraPosition:. | |
פונקציות סטטיות לחברי ציבור | |
| (instancetype) | + mapWithFrame:camera: |
| יוצרת ומחזירה תצוגת מפה עם פריים ויעד מצלמה. | |
| (instancetype) | + mapWithFrame:mapID:camera: |
| מאתחל נוח כדי ליצור ולהחזיר תצוגת מפה עם פריים, מזהה מפה ויעד מצלמה. | |
נכסים | |
| IBOutlet id< GMSMapViewDelegate > | להעביר סמכויות |
| משתמש עם הרשאה ל-GMSMapView. | |
| GMSCameraPosition * | מצלמה |
| שליטה במצלמה שקובעת את אופן הכיוון של המפה. | |
| GMSProjection * | תחזית |
| מחזירה אובייקט GMSProjection שאפשר להשתמש בו כדי להמיר בין קואורדינטות של מסך לבין קואורדינטות של קו אורך/רוחב. | |
| בוליאני | myLocationEnabled |
| המדיניות קובעת אם הנקודה 'המיקום שלי' ועיגול הדיוק מופעלים. | |
| CLLocation * | myLocation |
| אם 'המיקום שלי' מופעל, חושפים את המיקום שבו משורטטת נקודת המיקום של המכשיר. | |
| GMSMarker * | selectedMarker |
| הסמן שנבחר. | |
| בוליאני | trafficEnabled |
| המדיניות קובעת אם מוצגים במפה נתוני תנועה, אם יש נתונים זמינים. | |
| GMSMapViewType | mapType |
| המדיניות קובעת את סוג קטעי המפה שיש להציג. | |
| GMSMapStyle * | mapStyle |
| המדיניות קובעת את סגנון המפה. | |
| UIUserInterfaceStyle | overrideUserInterfaceStyle |
| משנים את המפה ל-UIUserInterfaceStyle הרצוי. | |
| float | minZoom |
| זום מינימלי (המרחק הגדול ביותר במצלמה). | |
| float | maxZoom |
| זום מקסימלי (המצלמה הקרובה ביותר יכולה להיות לכדור הארץ). | |
| בוליאני | buildingsEnabled |
| אם המדיניות מוגדרת, בניינים בתלת ממד יוצגו במקומות שבהם הם זמינים. | |
| בוליאני | indoorEnabled |
| המדיניות הזו מגדירה אם מפות פנים יוצגו, אם הן זמינות. | |
| GMSIndoorDisplay * | indoorDisplay |
| מקבל את המכונה GMSIndoorDisplay שמאפשרת לצפות בהיבטים של תצוגת הנתונים בתוך הארגון או לשלוט בהיבטים מסוימים. | |
| GMSUISettings * | הגדרות |
| מקבלת את האובייקט GMSUISettings, ששולט בהגדרות ממשק המשתמש במפה. | |
| UIEdgeInsets | מרווח פנימי |
| קובע את האזור ה 'גלוי' של התצוגה. | |
| GMSMapViewPaddingAdjustmentBehavior ל | paddingAdjustmentBehavior |
| המדיניות הזו קובעת איך להוסיף כניסות של אזורים בטוחים לערכי המרווח הפנימי. | |
| בוליאני | accessibilityElementsHidden |
| ברירת המחדל היא 'כן'. | |
| GMSMapLayer * | שכבה |
| רכיב הגישה לסוג CALayer המותאם אישית שמשמש לשכבה. | |
| GMSFrameRate | preferredFrameRate |
| המדיניות קובעת את קצב הפריימים של הרינדור. | |
| GMSCoordinateBounds * | cameraTargetBounds |
| אם הוא לא אפס, מגביל את יעד המצלמה כך שתנועות לא יגרמו ליציאה מהגבולות שצוינו. | |
| GMSMapCapabilityFlags | mapCapabilities |
| כל היכולות הזמינות באופן מותנה (בהתאם ל-mapID או הגדרות מפה אחרות) שזמינות כרגע בזמן נתון. | |
פונקציות קשורות | |
(שימו לב: אלו אינן פונקציות חבר). | |
| NSString *const | kGMSAccessibilityCompass |
| מזהה הנגישות של לחצן המצפן. | |
| NSString *const | kGMSAccessibilityMyLocation |
| מזהה הנגישות של הלחצן 'המיקום שלי'. | |
| NSString *const | kGMSAccessibilityOutOfQuota |
| מזהה הנגישות לתווית השגיאה 'מחוץ למכסה'. | |
מסמכי תיעוד בנושא פונקציות של חברים
| - (instancetype) init |
אתחול ב-CGRectZero ואפשרויות ברירת מחדל.
| - (instancetype) initWithOptions: | (nonnull GMSMapViewOptions *) | אפשרויות |
יצירה של תצוגת מפה חדשה עם האפשרויות הנתונות.
הערך של אובייקט האפשרויות מועתק באמצעות השיטה הזו.
| - (instancetype) initWithFrame: | (CGRect) | מסגרת |
| - (סוג מופע שיכול להיות null) initWithCoder: | (NSCoder *) | מקודד |
| + (instancetype) mapWithFrame: | (CGRect) | מסגרת | |
| מצלמה: | (GMSCameraPosition *) | מצלמה | |
יוצרת ומחזירה תצוגת מפה עם פריים ויעד מצלמה.
| + (instancetype) mapWithFrame: | (CGRect) | מסגרת | |
| mapID: | (GMSMapID *) | mapID | |
| מצלמה: | (GMSCameraPosition *) | מצלמה | |
מאתחל נוח כדי ליצור ולהחזיר תצוגת מפה עם פריים, מזהה מפה ויעד מצלמה.
| - (instancetype) initWithFrame: | (CGRect) | מסגרת | |
| מצלמה: | (GMSCameraPosition *) | מצלמה | |
יוצרת ומחזירה תצוגת מפה עם פריים ויעד מצלמה.
- הערה:
- הכלים האלה הוצאו משימוש. במקום זאת, אפשר להשתמש ב- -init או ב- -initWithOptions:
| - (instancetype) initWithFrame: | (CGRect) | מסגרת | |
| mapID: | (GMSMapID *) | mapID | |
| מצלמה: | (GMSCameraPosition *) | מצלמה | |
יוצר ומחזיר תצוגת מפה עם מסגרת, מזהה מפה ויעד מצלמה.
- הערה:
- הכלים האלה הוצאו משימוש. במקום זאת, אפשר להשתמש ב- -init או ב- -initWithOptions:
| - (מבוטל) startRendering |
מנחה את המפה הזו כדי לשפר את כלי הרינדור.
זוהי אפשרות אידמפוטנטית ואופציונלית.
- הערה:
- הכלים האלה הוצאו משימוש. השיטה הזו מיושנת והיא תוסר בגרסאות עתידיות.
| - (מבוטל) stopRendering |
מורה למפה הזו לכבות את כלי הרינדור.
זוהי אפשרות אידמפוטנטית ואופציונלית.
- הערה:
- הכלים האלה הוצאו משימוש. השיטה הזו מיושנת והיא תוסר בגרסאות עתידיות.
| - (מבוטל) ניקוי |
ניקוי כל תגי העיצוב שנוספו למפה, כולל סמנים, קווים פוליגוניים ושכבות-על של קרקע.
הפעולה הזו לא תנקה את נקודת המיקום הגלויה או תאפס את סוג המפה הנוכחי.
| - (cancel) setMinZoom: | (float) | minZoom | |
| maxZoom: | (float) | maxZoom | |
הגדרה של minZoom ו-maxZoom.
השיטה הזו מצפה שהמינימום יהיה קטן מהמקסימום או שווה לו, אחרת יגרום לחריגה בשם NSRange מתחילים.
| - (nullable GMSCameraPosition *) cameraForBounds: | (GMSCoordinateBounds *) | גבולות | |
| insets: | (UIEdgeInsets) | insets | |
בונים GMSCameraPosition שמציג את bounds עם padding.
למצלמה יהיה מינוף והטיה של אפס זווית (כלומר, לכיוון צפון ולהביט ישירות בכדור הארץ). הפעולה הזו מביאה בחשבון את הפריים והמרווח הפנימי של התצוגה ב-GMSMapView.
אם הגבולות לא תקינים, השיטה הזו תחזיר מצלמה אפסית.
| - (מבוטל) moveמצלמה: | (GMSCameraUpdate *) | עדכון |
החלפת המצלמה בהתאם ל-update.
החלפת המצלמה היא מיידית (ללא אנימציה).
| - (BOOL) areEqualForRenderingPosition: | (GMSCameraPosition *) | מיקום | |
| מיקום: | (GMSCameraPosition *) | otherPosition | |
בדקו אם מיקומי המצלמה הנתונים יגרמו בפועל להצגת המצלמה באותו אופן, תוך התחשבות ברמת הדיוק והטרנספורמציות בשימוש פנימי.
| - (GMSFeatureLayer<GMSPlaceFeature *> *) featureLayerOfFeatureType: | (GMSFeatureType) | featureType |
מחזירה שכבה של תכונה מהסוג שצוין.
יש להגדיר את שכבות התכונות במסוף Cloud.
אם לא קיימת שכבה מהסוג שצוין במפה הזו, או אם סגנון מבוסס-נתונים לא מופעל, או אם לא נעשה שימוש במסגרת עיבוד המטאל, השכבה שמתקבלת תהיה NO ולא תגיב לקריאות.
נדרש רינדור מתכות. מידע נוסף על הפעלת מטאל זמין בכתובת https://developers.google.com/maps/documentation/ios-sdk/config#use-metal.
| - (GMSDatasetFeatureLayer *) datasetFeatureLayerOfDatasetID: | (NSString *) | datasetID |
מחזירה שכבה של מאפיין מערך הנתונים של מערך הנתונים שצוין.
יש להגדיר את המזהים של מערכי הנתונים במסוף Cloud.
אם מערך נתונים של המזהה שצוין לא קיים במפה הזו, או אם סגנון מבוסס-נתונים לא מופעל, isAvailable של השכבה שמתקבלת יהיה NO ולא תגיב לקריאות כלשהן.
| - (ריק) animateTocameraPosition: | (GMSCameraPosition *) | cameraPosition |
הוספת אנימציה של המצלמה של המפה הזו ל-cameraPosition.
| - (מבוטל) animateToLocation: | (CLLocationCoordinate2D) | מיקום |
כ-animateTocameraPosition:, אבל משנה רק את מיקום המצלמה (כלומר, מהמיקום הנוכחי ל-location).
| - (מבוטל) animateToZoom: | (float) | שינוי מרחק התצוגה |
כ-animateTocameraPosition:, אבל משנה רק את רמת הזום של המצלמה.
הערך הזה מוצמד על ידי [kGMSMinZoomLevel, kGMSMaxZoomLevel].
| - (מבוטל) animateToBearing: | (כיוון CLLocation) | נושא |
כ-animateTo CameraPosition: אבל משנה רק את כיוון המצלמה (במעלות).
אפס מציין את הצפון האמיתי.
| - (מבוטל) animateToViewAngle: | (כפול) | viewingAngle |
כ-animateTo CameraPosition: אבל משנה רק את זווית הצפייה של המצלמה (במעלות).
הערך הזה יוצמד למינימום של אפס (כלומר, כלפי מטה) ובין 30 ל-45 מעלות לכיוון האופק, בהתאם לקרבה היחסית לכדור הארץ.
| - (מבוטל) animateWithcameraUpdate: | (GMSCameraUpdate *) | cameraUpdate |
המערכת מחילה את cameraUpdate על המצלמה הנוכחית, ולאחר מכן משתמשת בתוצאה בהתאם ל-animateTocameraPosition:.
תיעוד של חברים ופונקציות קשורות
- (NSString* const) kGMSAccessibilityCompass [related] |
מזהה הנגישות של לחצן המצפן.
- (NSString* const) kGMSAccessibilityMyLocation [related] |
מזהה הנגישות של הלחצן 'המיקום שלי'.
- (NSString* const) kGMSAccessibilityOutOfQuota [related] |
מזהה הנגישות לתווית השגיאה 'מחוץ למכסה'.
תיעוד של נכס
- (IBOutlet id<GMSMapViewDelegate>) מאציל [read, write, assign] |
משתמש עם הרשאה ל-GMSMapView.
- (GMSCameraPosition*) מצלמה [read, write, copy] |
שליטה במצלמה שקובעת את אופן הכיוון של המפה.
השינוי של הנכס הזה מתבצע באופן מיידי.
- (GMSProjection*) תחזית [read, assign] |
מחזירה אובייקט GMSProjection שאפשר להשתמש בו כדי להמיר בין קואורדינטות של מסך לבין קואורדינטות של קו אורך/רוחב.
זו תמונת מצב של ההקרנה הנוכחית, שלא תתעדכן באופן אוטומטי כשהמצלמה תזוז. הוא מייצג את ההיטל של המסגרת האחרונה שצולמה ב-GMSMapView, או המיקום שבו המצלמה הוגדרה במפורש או שהמפה נוצרה – הפריים הבא. זה אף פעם לא יהיה אפס.
- (BOOL) myLocationEnabled [read, write, assign] |
המדיניות קובעת אם הנקודה 'המיקום שלי' ועיגול הדיוק מופעלים.
ברירת המחדל היא NO.
- (CLLocation*) myLocation [read, assign] |
אם 'המיקום שלי' מופעל, חושפים את המיקום שבו משורטטת נקודת המיקום של המכשיר.
אם היא מושבתת או מופעלת אך אין נתוני מיקום זמינים, הערך יהיה אפס. ניתן לצפות בנכס הזה באמצעות KVO.
- (GMSMarker*) selectedMarker [read, write, assign] |
הסמן שנבחר.
הגדרת המאפיין הזה בוחרת סמן מסוים, שמוצג עליו חלון מידע. אם המאפיין הזה הוא לא אפס, הגדרתו כ-n מבטלת את הבחירה בסמן ומסתירה את חלון המידע. ניתן לצפות בנכס הזה באמצעות KVO.
- (BOOL) trafficEnabled [read, write, assign] |
המדיניות קובעת אם מוצגים במפה נתוני תנועה, אם יש נתונים זמינים.
הגישה אליו תלויה בזמינות של נתוני התנועה. ברירת המחדל היא NO.
- (GMSMapViewType) mapType [read, write, assign] |
המדיניות קובעת את סוג קטעי המפה שיש להציג.
ברירת המחדל היא kGMSTypeStandard.
- (GMSMapStyle*) mapStyle [read, write, assign] |
המדיניות קובעת את סגנון המפה.
MapType הוא לא אפסי יחול רק אם MapType הוא 'רגיל'.
– (UIUserInterfaceStyle) overrideUserInterfaceStyle [read, write, assign] |
משנים את המפה ל-UIUserInterfaceStyle הרצוי.
הפעולה הזו מבטלת את התנהגות ברירת המחדל של UIKit ומוגדרת כברירת מחדל ל-UIUserInterfaceStyleLight כדי להבטיח תאימות לאחור. המדיניות הזו משפיעה על ערכת הצבעים של המפה 'רגילה' ו'פני השטח'.
- (צף) minZoom [read, assign] |
זום מינימלי (המרחק הגדול ביותר במצלמה).
ברירת המחדל היא kGMSMinZoomLevel. שונה באמצעות -setMinZoom:maxZoom:.
- (צף) maxZoom [read, assign] |
זום מקסימלי (המצלמה הקרובה ביותר יכולה להיות לכדור הארץ).
ברירת המחדל היא kGMSMaxZoomLevel. שונה באמצעות -setMinZoom:maxZoom:.
- (BOOL) buildingsEnabled [read, write, assign] |
אם המדיניות מוגדרת, בניינים בתלת ממד יוצגו במקומות שבהם הם זמינים.
ברירת המחדל היא 'כן'.
האפשרות הזו יכולה להיות שימושית כשמוסיפים למפה שכבה מותאמת אישית של משבצות, כדי להבהיר אותה יותר ברמות זום גבוהות. שינוי הערך הזה יגרום לביטול התוקף של כל המשבצות לזמן קצר.
- (BOOL) indoorEnabled [read, write, assign] |
המדיניות הזו מגדירה אם מפות פנים יוצגו, אם הן זמינות.
ברירת המחדל היא 'כן'.
אם המדיניות מוגדרת כ-NO, קבצים שמורים של נתונים פנימיים עשויים להימחק באופן סופי וכל רצפה שנבחרה על ידי משתמש הקצה עשויה להתאפס.
- (GMSIndoorDisplay*) indoorDisplay [read, assign] |
מקבל את המכונה GMSIndoorDisplay שמאפשרת לצפות בהיבטים של תצוגת הנתונים בתוך הארגון או לשלוט בהיבטים מסוימים.
- (GMSUISettings*) הגדרות [read, assign] |
מקבלת את האובייקט GMSUISettings, ששולט בהגדרות ממשק המשתמש במפה.
- (UIEdgeInsets) מרווח פנימי [read, write, assign] |
קובע את האזור ה 'גלוי' של התצוגה.
על ידי החלת מרווח פנימי מסביב לקצה התצוגה ניתן ליצור שיכיל נתוני מפה אבל לא יכיל פקדים בממשק המשתמש.
אם המרווח הפנימי לא מאוזן, המרכז החזותי של התצוגה יזוז בהתאם לצורך. המרווח הפנימי ישפיע גם על המאפיין projection, כך שהאזור הגלוי לא יכלול את המרווח הפנימי. FitToBounds של GMSCameraUpdate יבטיח שהמרווח הפנימי הזה וכל המרווח הפנימי המבוקש יובאו בחשבון.
המאפיין הזה יכול להיות מונפש בתוך בלוק אנימציה מבוסס UIView.
- (GMSMapViewPaddingAdjustmentBehavior ) paddingAdjustmentBehavior [read, write, assign] |
המדיניות הזו קובעת איך להוסיף כניסות של אזורים בטוחים לערכי המרווח הפנימי.
בדומה לרווחים, פקדי מיקום של האזור הבטוח כוללים פקדי מיקום, כגון המצפן, לחצן המיקום שלי ובוחר הקומה בתוך האזור הבטוח של המכשיר.
ערך ברירת המחדל הוא kGMSMapViewP הישןצופהTracking (התנהגות בברירת המחדל)
- (BOOL) accessibilityElementsHidden [read, write, assign] |
ברירת המחדל היא 'כן'.
אם המדיניות מוגדרת כ-NO, הפונקציה GMSMapView תיצור רכיבי נגישות לאובייקטים של שכבות-על, כמו GMSMarker ו-GMSPolyline.
המאפיין הזה פועל לפי פרוטוקול UIAccessibility הלא רשמי, למעט ערך ברירת המחדל YES (כן).
- (GMSMapLayer*) שכבה [read, retain] |
רכיב הגישה לסוג CALayer המותאם אישית שמשמש לשכבה.
- (GMSFrameRate ) preferredFrameRate [read, write, assign] |
המדיניות קובעת את קצב הפריימים של הרינדור.
ערך ברירת המחדל הוא kGMSFrameRateMax.
- (GMSCoordinateBounds*) cameraTargetBounds [read, write, assign] |
אם הוא לא אפס, מגביל את יעד המצלמה כך שתנועות לא יגרמו ליציאה מהגבולות שצוינו.
- (GMSMapCapabilityFlags) mapCapabilities [read, assign] |
כל היכולות הזמינות באופן מותנה (בהתאם ל-mapID או הגדרות מפה אחרות) שזמינות כרגע בזמן נתון.
היא לא כוללת יכולות שזמינות תמיד.