סקירה כללית
זוהי המחלקה העיקרית של ה-SDK של מפות Google ל-iOS, והיא נקודת הכניסה לכל השיטות שקשורות למפה.
יש ליצור את המפה באמצעות אחד מהבנאים -init או -initWithOptions:.
אפשר לקרוא ולשנות את GMSMapView רק מה-thread הראשי, בדומה לכל האובייקטים של UIKit. קריאה ל-methods משרשור אחר תוביל לחריגת או להתנהגות לא מוגדרת.
פונקציות חברים ציבוריים | |
| (instancetype) | – init |
| אתחול ב-CGRectZero ואפשרויות ברירת מחדל. | |
| (instancetype) | - initWithOptions: |
| יצירה של תצוגת מפה חדשה עם האפשרויות הנתונות. | |
| (instancetype) | - initWithFrame: |
| (סוג מופע ריק) | – initWithCoder: |
| (instancetype) | - initWithFrame:camera: |
| יוצרת ומחזירה תצוגת מפה עם פריים ויעד מצלמה. | |
| (instancetype) | - initWithFrame:mapID:camera: |
| יוצר ומחזיר תצוגת מפה עם מסגרת, מזהה מפה ויעד מצלמה. | |
| (מבוטל) | – startRendering |
| מנחה את המפה הזו כדי לשפר את כלי הרינדור. | |
| (מבוטל) | – stopRendering |
| מורה למפה הזו לכבות את כלי הרינדור. | |
| (מבוטל) | - נקי |
| ניקוי כל תגי העיצוב שנוספו למפה, כולל סמנים, קווים פוליגוניים ושכבות-על של קרקע. | |
| (מבוטל) | – setMinZoom:maxZoom: |
הגדרה של minZoom ו-maxZoom. | |
| (null GMSCameraPosition *) | - cameraForBounds:insets: |
בונים GMSCameraPosition שמציג את bounds עם padding. | |
| (מבוטל) | - moveCamera: |
החלפת המצלמה בהתאם ל-update. | |
| (BOOL) | – areEqualForRenderingPosition:position: |
| בדקו אם מיקומי המצלמה הנתונים יגרמו בפועל להצגת המצלמה באותו אופן, תוך התחשבות ברמת הדיוק והטרנספורמציות בשימוש פנימי. | |
| (GMSFeatureLayer < GMSPlaceFeature * > *) | - featureLayerOfFeatureType: |
| מחזירה שכבה של תכונה מהסוג שצוין. | |
| (GMSDatasetFeatureLayer *) | – datasetFeatureLayerOfDatasetID: |
| מחזירה שכבה של מאפיין מערך הנתונים של מערך הנתונים שצוין. | |
| (מבוטל) | – animateToCameraPosition: |
הוספת אנימציה של המצלמה של המפה הזו ל-cameraPosition. | |
| (מבוטל) | - animateToLocation: |
כ-animateTocameraPosition:, אבל משנה רק את מיקום המצלמה (כלומר, מהמיקום הנוכחי ל-location). | |
| (מבוטל) | – animateToZoom: |
| כ-animateTocameraPosition:, אבל משנה רק את רמת הזום של המצלמה. | |
| (מבוטל) | – animateToBearing: |
| כ-animateTo CameraPosition: אבל משנה רק את כיוון המצלמה (במעלות). | |
| (מבוטל) | – animateToViewingAngle: |
| כ-animateTo CameraPosition: אבל משנה רק את זווית הצפייה של המצלמה (במעלות). | |
| (מבוטל) | – animateWithCameraUpdate: |
המערכת מחילה את cameraUpdate על המצלמה הנוכחית, ולאחר מכן משתמשת בתוצאה בהתאם ל-animateTocameraPosition:. | |
פונקציות סטטיות של חברים ציבוריים | |
| (instancetype) | + mapWithFrame:camera: |
| יוצרת ומחזירה תצוגת מפה עם פריים ויעד מצלמה. | |
| (instancetype) | + mapWithFrame:mapID:camera: |
| מאתחל נוח כדי ליצור ולהחזיר תצוגת מפה עם פריים, מזהה מפה ויעד מצלמה. | |
מאפיינים | |
| מזהה IBOutlet< GMSMapViewDelegate > | להעביר סמכויות |
| משתמש עם הרשאה ל-GMSMapView. | |
| GMSCameraPosition * | מצלמה |
| שליטה במצלמה שקובעת את אופן הכיוון של המפה. | |
| GMSProjection * | תחזית |
| מחזירה אובייקט GMSProjection שאפשר להשתמש בו כדי להמיר בין קואורדינטות של מסך לבין קואורדינטות של קו אורך/רוחב. | |
| בוליאני | myLocationEnabled |
| המדיניות קובעת אם הנקודה 'המיקום שלי' ועיגול הדיוק מופעלים. | |
| קל מיקום * | myLocation |
| אם 'המיקום שלי' מופעל, חושפים את המיקום שבו משורטטת נקודת המיקום של המכשיר. | |
| GMSMarker * | selectedMarker |
| הסמן שנבחר. | |
| בוליאני | trafficEnabled |
| המדיניות קובעת אם מוצגים במפה נתוני תנועה, אם יש נתונים זמינים. | |
| GMSMapViewType | mapType |
| המדיניות קובעת את סוג קטעי המפה שיש להציג. | |
| GMSMapStyle * | mapStyle |
| המדיניות קובעת את סגנון המפה. | |
| UIUserInterfaceStyle | overrideUserInterfaceStyle |
| משנים את המפה ל-[UIUserInterfaceStyle](https://developer.apple.com/documentation/uikit/uiuserinterfacestyle?language=objc). | |
| מספר ממשי (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: | (צף) | minZoom | |
| maxZoom: | (צף) | maxZoom | |
הגדרה של minZoom ו-maxZoom.
השיטה הזו מצפה שהמינימום יהיה קטן מהמקסימום או שווה לו, אחרת יגרום לחריגה בשם NSRange מתחילים.
| - (null GMSCameraPosition *) CameraForBounds: | (GMSCoordinateBounds *) | גבולות | |
| insets: | (UIEdgeInsets) | insets | |
בונים GMSCameraPosition שמציג את bounds עם padding.
למצלמה יהיה מינוף והטיה של אפס זווית (כלומר, לכיוון צפון ולהביט ישירות בכדור הארץ). הפעולה הזו מביאה בחשבון את הפריים והמרווח הפנימי של התצוגה ב-GMSMapView.
אם הגבולות לא תקינים, השיטה הזו תחזיר מצלמה אפסית.
| - (מבוטל) moveCamera:: | (GMSCameraUpdate *) | עדכון |
החלפת המצלמה בהתאם ל-update.
החלפת המצלמה היא מיידית (ללא אנימציה).
| - (BOOL) areEqualForRenderingPosition: | (GMSCameraPosition *) | מיקום | |
| מיקום: | (GMSCameraPosition *) | otherPosition | |
בדקו אם מיקומי המצלמה הנתונים יגרמו בפועל להצגת המצלמה באותו אופן, תוך התחשבות ברמת הדיוק והטרנספורמציות בשימוש פנימי.
| - (GMSFeatureLayer<GMSPlaceFeature *> *) featureLayerOfFeatureType: | (GMSFeatureType) | featureType |
מחזירה שכבה של תכונה מהסוג שצוין.
יש להגדיר את שכבות התכונות במסוף Cloud.
אם לא קיימת שכבה מהסוג שצוין במפה הזו, או אם סגנון מבוסס-נתונים לא מופעל, או אם לא נעשה שימוש במסגרת עיבוד המטאל, הערך 'isAvailable' של השכבה שמתקבלת יהיה 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: | (צף) | שינוי מרחק התצוגה |
כ-animateTocameraPosition:, אבל משנה רק את רמת הזום של המצלמה.
הערך הזה מוצמד על ידי [kGMSMinZoomLevel, kGMSMaxZoomLevel].
| - (מבוטל) animateToBearing: | (CLLocationDirection) | נושא |
כ-animateTo CameraPosition: אבל משנה רק את כיוון המצלמה (במעלות).
אפס מציין את הצפון האמיתי.
| - (מבוטל) animateToViewingAngle: | (כפול) | 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](https://developer.apple.com/documentation/uikit/uiuserinterfacestyle?language=objc).
הפעולה הזו מבטלת את התנהגות ברירת המחדל של 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 או הגדרות מפה אחרות) שזמינות כרגע בזמן נתון.
היא לא כוללת יכולות שזמינות תמיד.