סקירה כללית
זוהי הסיווג העיקרי של ה-SDK של מפות Google ל-iOS ונקודת הכניסה לכל השיטות הקשורות למפה.
המפה צריכה ליצור אובייקט עם אחד מהמבנים -init או -initWithOptions:.
אפשר לקרוא ולשנות את GMSMapView רק מה-thread הראשי, כמו כל האובייקטים ב-UIKit. קריאה לשיטות האלה משרשור אחר תגרום לחריגה או להתנהגות לא מוגדרת.
פונקציות של חברי מועדון | |
(instancetype) | - init |
מופעלת באמצעות CGRectZero ואפשרויות ברירת המחדל. | |
(instancetype) | - initWithOptions: |
יצירה של תצוגת מפה חדשה עם האפשרויות הנתונות. | |
(instancetype) | - initWithFrame: |
(nullable instancetype) | - 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) | - העברת המצלמה: |
שינוי המצלמה בהתאם לupdate . | |
(BOOL) | – areEqualForRenderingPosition:position: |
בדקו אם מיקומי המצלמה הנתונים יגרמו למעשה לעיבוד זהה של המצלמה, תוך התחשבות ברמת הדיוק והטרנספורמציות שנעשה בהן שימוש פנימי. | |
(GMSFeatureLayer < GMSPlaceFeature * > *) | - featureLayerOfFeatureType: |
מחזירה שכבת תכונה מהסוג שצוין. | |
(GMSDatasetFeatureLayer *) | – datasetFeatureLayerOfDatasetID: |
מחזירה את שכבת התכונה של מערך הנתונים שצוין. | |
(void) | – inVerifyLayoutForAccessoryView: |
מבטלת את התוקף של תצוגת האביזר ומפעיל פריסה מחדש של התצוגה הזו. | |
(void) | – setHeaderAccessoryView: |
המדיניות מגדירה את המיקום של תצוגת האביזרים מתחת לכותרת הראשית של ממשק המשתמש של הניווט. | |
(void) | – animateTo CameraPosition: |
הפעלת האנימציה של המצלמה של המפה הזו ל-cameraPosition . | |
(void) | - animateToLocation: |
כ-animateTocameraPosition:, אבל משנה רק את המיקום של המצלמה (כלומר, מהמיקום הנוכחי ל-location ). | |
(void) | - animateToZoom: |
כ-animateTo CameraPosition:, אבל תשנה רק את רמת הזום של המצלמה. | |
(void) | - animateToBearing: |
כ-animateTo CameraPosition:, אבל משנה רק את כיוון המצלמה (במעלות). | |
(void) | - animateToViewingAngle: |
כ-animateTo CameraPosition:, אבל משנה רק את זווית הצפייה של המצלמה (במעלות). | |
(void) | – animateWithcameraUpdate: |
מחיל את cameraUpdate על המצלמה הנוכחית, ולאחר מכן משתמש בתוצאה בהתאם ל-animateTo CameraPosition:. | |
(void) | - didBeginPanGesture |
יש להפעיל את השיטה הזו מתוך היישום של שיטת CPMapTemplateDelegate -mapTemplateDidBeginPanהענקת תנועה: כדי להטמיע תנועות הזזה עבור תבניות מפה של CarPlay. | |
(void) | - didUpdatePan TransactionWithTranslation:velocity: |
יש לקרוא לשיטה זו מתוך היישום של שיטת CPMapTemplateDelegate -mapTemplate:didUpdatePanmotionWithTranslation: כדי להטמיע תנועות הזזה עבור תבניות מפה של CarPlay. | |
(void) | - didEndPanmotionWithVelocity: |
יש להפעיל את השיטה הזו מתוך היישום של שיטת CPMapTemplateDelegate -mapTemplate:didEndPanSequenceWithVelocity: כדי להטמיע תנועות הזזה עבור תבניות המפה של CarPlay. | |
(BOOL) | - enableNavigationWithSession: |
מתחיל את הניווט בתצוגת מפה זו באמצעות סשן הניווט הנתון. | |
פונקציות סטטיות של חברים ציבוריים | |
(instancetype) | + mapWithFrame:camera: |
יוצר ומחזיר תצוגת מפה עם מסגרת ויעד מצלמה. | |
(instancetype) | + mapWithFrame:mapID:camera: |
מאתחל נוחות ליצירה והחזרה של תצוגת מפה עם מסגרת, מזהה מפה ויעד מצלמה. | |
נכסים | |
מזהה IBOutlet< GMSMapViewDelegate > | להאציל |
בעל/ת גישה ל-GMSMapView. | |
GMSCameraPosition * | מצלמה |
שולטת במצלמה, שקובעת את כיוון המפה. | |
GMSProjection * | תחזית |
מחזירה אובייקט GMSProjection שניתן להשתמש בו כדי להמיר בין קואורדינטות של מסך לקואורדינטות של קווי אורך/רוחב. | |
בוליאני | myLocationEnabled |
המדיניות הזו קובעת אם הנקודה ומעגל הדיוק של 'המיקום שלי' מופעלים. | |
CLLocation * | 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 או בהגדרות מפה אחרות) שזמינות כרגע. | |
מזהה IBOutlet < GMSMapViewNavigationUIDelegate > | navigationUIDelegate |
נציג של GMSMapView שמקבל קריאות חוזרות (callback) עבור אירועי ניווט בממשק המשתמש. | |
בוליאני | navigationEnabled |
האם פונקציונליות הניווט מופעלת עבור המפה הזו. | |
GMSNavigator * | ניווט |
ניווט עבור GMSMapView זה, שמאפשר לבקש מסלולים ולהתחיל לקבל מסלול מפורט. | |
GMSRoadSnappedLocationProvider * | roadSnappedLocationProvider |
מאפשר הרשמה לעדכוני מיקום מוצמדים. | |
GMSLocationSimulator * | locationSimulator |
ההגדרה מאפשרת לדמות את מיקום המכשיר. | |
GMSNavigationCameraMode | cameraMode |
מצב המצלמה שקובע את ההתנהגות שלה כשהמאפיין navigationEnabled מוגדר ל-YES. | |
GMSNavigationCameraPerspective | followingPerspective |
נקודת המבט של המצלמה שתשמש למעקב אחר מיקום המכשיר. | |
GMSNavigationTravelMode | travelMode |
מצב הנסיעה שקובע את סוג המסלולים שיאוחזרו והדרך שבה נקבע מסלול המכשיר. | |
GMSNavigationLightingMode | lightingMode |
מצב התאורה קובע באיזו ערכת צבעים להשתמש להצגת המפה. | |
בוליאני | shouldDisplaySpeedLimit |
המדיניות הזו קובעת אם מגבלת המהירות תוצג כשההנחיה פעילה והנתונים על מגבלת המהירות זמינים. | |
בוליאני | shouldDisplaySpeedometer |
ההגדרה קובעת אם סמל מד המהירות מוצג. | |
UILayoutGuide * | navigationHeaderLayoutGuide |
המלבן שמכוסה על ידי כותרת הניווט. | |
UILayoutGuide * | navigationFooterLayoutGuide |
המלבן שמכוסה על ידי הכותרת התחתונה של הניווט. | |
GMSNavigationRouteCalloutFormat | routeCalloutFormat |
המדיניות קובעת באיזה פורמט של יתרונות מרכזיים של המסלול (ברירת מחדל, זמן או מרחק) להשתמש. | |
float | followingZoomLevel |
רמה מותאמת אישית של מרחק התצוגה במהלך הניווט. | |
GMSRoadSnappedLocationProvider * | roadSnappedMyLocationSource |
מגדיר את ספק המיקום שלי לתצוגת מפה זו. | |
פונקציות קשורות | |
(שימו לב: אלו אינן פונקציות חבר). | |
NSString *const | kGMSAccessibilityCompass |
מזהה נגישות של לחצן המצפן. | |
NSString *const | kGMSAccessibilityMyLocation |
מזהה נגישות של הלחצן 'המיקום שלי'. | |
NSString *const | kGMSAccessibilityOutOfQuota |
מזהה נגישות של תווית השגיאה 'חריגה מהמכסה'. |
מסמכי תיעוד לגבי פונקציות של חברים
- (instancetype) init |
מופעלת באמצעות CGRectZero ואפשרויות ברירת המחדל.
- (instancetype) initWithOptions: | (nonnull GMSMapViewOptions *) | אפשרויות |
יצירה של תצוגת מפה חדשה עם האפשרויות הנתונות.
הערך של אובייקט האפשרויות מועתק בשיטה הזו.
- (instancetype) initWithFrame: | (CGRect) | מסגרת |
- (nullable instancetype) initWithCoder: | (NSCoder *) | מקודד |
+ (instancetype) mapWithFrame: | (CGRect) | מסגרת | |
מצלמה: | (GMSCameraPosition *) | מצלמה | |
יוצר ומחזיר תצוגת מפה עם מסגרת ויעד מצלמה.
+ (instancetype) mapWithFrame: | (CGRect) | מסגרת | |
מזהה מפה: | (GMS MapID *) | mapID | |
מצלמה: | (GMSCameraPosition *) | מצלמה | |
מאתחל נוחות ליצירה והחזרה של תצוגת מפה עם מסגרת, מזהה מפה ויעד מצלמה.
- (instancetype) initWithFrame: | (CGRect) | מסגרת | |
מצלמה: | (GMSCameraPosition *) | מצלמה | |
יוצר ומחזיר תצוגת מפה, עם מסגרת ויעד מצלמה.
- הערה:
- השיטה הזו הוצאה משימוש. במקום זאת, צריך להשתמש ב- -init או ב- -initWithOptions: .
- (instancetype) initWithFrame: | (CGRect) | מסגרת | |
מזהה מפה: | (GMS MapID *) | mapID | |
מצלמה: | (GMSCameraPosition *) | מצלמה | |
יוצרת ומחזירה תצוגת מפה עם מסגרת, מזהה מפה ויעד מצלמה.
- הערה:
- השיטה הזו הוצאה משימוש. במקום זאת, צריך להשתמש ב- -init או ב- -initWithOptions: .
- (ביטול) startRendering |
מורה למפה זו להפעיל את כלי הרינדור.
זה אופציונלי ואידמפוטנטי.
- הערה:
- השיטה הזו הוצאה משימוש. השיטה הזו מיושנת ותוסר בגרסה עתידית.
- (ביטול) stopRendering |
מורה למפה זו לכבות את כלי הרינדור.
זה אופציונלי ואידמפוטנטי.
- הערה:
- השיטה הזו הוצאה משימוש. השיטה הזו מיושנת ותוסר בגרסה עתידית.
- (ביטול) ברור |
מנקה את כל תגי העיצוב שנוספו למפה, כולל סמנים, קווים פוליגוניים ושכבות-על של קרקע.
פעולה זו לא תנקה את נקודת המיקום הגלויה ולא תאפס את סוג המפה הנוכחי.
- (ביטול) setMinZoom: | (float) | minZoom | |
maxZoom: | (float) | maxZoom | |
מגדירה את minZoom
ואת maxZoom
.
השיטה הזו מצפה שהמינימום יהיה נמוך מהערך המקסימלי או שווה לו, ובמקרה אחר, תופיע חריגה עם השם NSRange לחריגה.
- (nullable GMSCameraPosition *) cameraForBounds: | (GMSCoordinateBounds *) | גבולות | |
insets: | (UIEdgeInsets) | insets | |
בניית GMSCameraPosition שמציגה את bounds
עם padding
.
למצלמה תהיה סיבוב והטיה באפס (כלומר, המצלמה פונה צפונה ומסתכלת ישירות על כדור הארץ). הפעולות האלה לוקחות בחשבון את המסגרת והמרווח הפנימי של GMSMapView.
אם הגבולות לא חוקיים, השיטה הזו תחזיר מצלמת אפס.
- (בטל) movecamera: | (GMSCameraUpdate *) | עדכון |
שינוי המצלמה בהתאם לupdate
.
שינוי המצלמה מתרחש באופן מיידי (ללא אנימציה).
- (BOOL) areEqualForRenderingPosition: | (GMSCameraPosition *) | מיקום | |
מיקום: | (GMSCameraPosition *) | otherPosition | |
בדקו אם מיקומי המצלמה הנתונים יגרמו למעשה לעיבוד זהה של המצלמה, תוך התחשבות ברמת הדיוק והטרנספורמציות שנעשה בהן שימוש פנימי.
- (GMSFeatureLayer<GMSPlaceFeature *> *) featureLayerOfFeatureType: | (GMSFeatureType) | featureType |
מחזירה שכבת תכונה מהסוג שצוין.
את שכבות התכונות צריך להגדיר במסוף Cloud.
אם שכבה מהסוג שצוין לא קיימת במפה הזו, או אם סגנון מבוסס-נתונים לא מופעל או אם לא נעשה שימוש ב-framework לעיבוד מטאלי, ה-isAvailable
של השכבה שתתקבל יהיה NO
ולא יגיב לקריאות.
נדרש הכלי לרינדור מתכת. בקישור הבא אפשר ללמוד איך להפעיל מטאל https://developers.google.com/maps/documentation/ios-sdk/config#use-metal.
- (GMSDatasetFeatureLayer *) datasetFeatureLayerOfDatasetID: | (NSString *) | datasetID |
מחזירה את שכבת התכונה של מערך הנתונים שצוין.
יש להגדיר מזהי מערכי נתונים במסוף Cloud.
אם מערך נתונים של המזהה שצוין לא קיים במפה הזו, או אם סגנון מבוסס-נתונים לא מופעל, הערך של isAvailable
בשכבה שתתקבל יהיה NO
, ולא יגיבו לקריאות.
- (ביטול) inVerifyLayoutForAccessoryView: | (UIView< GMSNavigationAccessoryView > *) | accessoryView |
מבטלת את התוקף של תצוגת האביזר ומפעיל פריסה מחדש של התצוגה הזו.
התצוגה חייבת להיות אחת מתצוגות האביזרים הנוכחיות. אם ההנחיה לא פעילה, השיחה הזו היא הוראה מסוג NO-OP.
- (ביטול) setHeaderAccessoryView: | (nullable UIView< GMSNavigationAccessoryView > *) | headerAccessoryView |
המדיניות מגדירה את המיקום של תצוגת האביזרים מתחת לכותרת הראשית של ממשק המשתמש של הניווט.
הזנת ערך אפס מסירה את תצוגת האביזר. אם ההנחיה לא פעילה, השיחה הזו היא הוראה מסוג NO-OP.
@note אם תצוגת המפה קצרה, ה-SDK מסתיר את תצוגת האביזרים עקב מקום מוגבל. התצוגות מנוהלות באופן פנימי כדי לבצע אופטימיזציה של תצוגת המפה.
- (ביטול) animateTo CameraPosition: | (GMSCameraPosition *) | cameraPosition |
הפעלת האנימציה של המצלמה של המפה הזו ל-cameraPosition
.
- (ביטול) animateToLocation: | (CLLocationCoordinate2D) | מיקום |
כ-animateTocameraPosition:, אבל היא משנה רק את מיקום המצלמה (כלומר, מהמיקום הנוכחי ל-location
).
- (בטל) animateToZoom: | (float) | שינוי מרחק התצוגה |
כ-animateTo CameraPosition:, אבל תשנה רק את רמת הזום של המצלמה.
הערך הזה מוגבל על ידי [kGMSMinZoomLevel, kGMSMaxZoomLevel].
- (ביטול) animateToBearing: | (CLLocationDirect) | נושא |
כ-animateTo CameraPosition:, אבל משנה רק את כיוון המצלמה (במעלות).
אפס מציין את הצפון האמיתי.
- (ביטול) animateToViewingAngle: | (כפול) | viewingAngle |
כ-animateTo CameraPosition:, אבל משנה רק את זווית הצפייה של המצלמה (במעלות).
הערך הזה יהיה מוצמד למינימום של אפס (כלומר, כלפי מטה) ובין 30 ל-45 מעלות לכיוון האופק, בהתאם לקרבה היחסית לכדור הארץ.
- (ביטול) animateWithcameraUpdate: | (GMSCameraUpdate *) | cameraUpdate |
מחיל את cameraUpdate
על המצלמה הנוכחית, ולאחר מכן משתמש בתוצאה בהתאם ל-animateTo CameraPosition:.
- (ביטול) didBeginPanGesture |
יש להפעיל את השיטה הזו מתוך היישום של שיטת CPMapTemplateDelegate -mapTemplateDidBeginPanהענקת תנועה: כדי להטמיע תנועות הזזה עבור תבניות מפה של CarPlay.
- (ריק) didUpdatePanmotionWithTranslation: | (CGPoint) | תרגום | |
מהירות: | (CGPoint) | velocity | |
יש לקרוא לשיטה זו מתוך היישום של שיטת CPMapTemplateDelegate -mapTemplate:didUpdatePanmotionWithTranslation: כדי להטמיע תנועות הזזה עבור תבניות מפה של CarPlay.
- (בטל) didEndPanSequenceWithVelocity: | (CGPoint) | מהירות |
יש להפעיל את השיטה הזו מתוך היישום של שיטת CPMapTemplateDelegate -mapTemplate:didEndPanSequenceWithVelocity: כדי להטמיע תנועות הזזה עבור תבניות המפה של CarPlay.
- (BOOL) enableNavigationWithSession: | (GMSNavigationSession *) | navigationSession |
מתחיל את הניווט בתצוגת מפה זו באמצעות סשן הניווט הנתון.
- הערה:
- כדי להשתמש בזיכרון ובמעבד (CPU) באופן יעיל ביותר, צריך לקרוא לשיטה הזו לפני שמפעילים שיטות אחרות שקשורות לניווט בתצוגת המפה.
- החזרות:
- אם הניווט התחיל בהצלחה (למשל, תוחזר 'לא' אם התנאים וההגבלות עדיין לא אושרו).
מסמכי עזרה של חברים ופונקציות קשורות
- (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] |
המדיניות הזו קובעת אם הנקודה ומעגל הדיוק של 'המיקום שלי' מופעלים.
ברירת המחדל היא 'לא'.
- (CLLocation*) myLocation [read, assign] |
אם 'המיקום שלי' מופעל, חושף המיקום של נקודה במכשיר.
אם הוא מושבת, או שהוא מופעל אבל אין נתוני מיקום זמינים, המספר יהיה אפס. המאפיין הזה ניתן למדידה באמצעות KVO.
- (GMSMarker*) selectedMarker [read, write, assign] |
הסמן שנבחר.
בהגדרת הנכס הזה נבחר סמן מסוים, שמציג חלון מידע עליו. אם המאפיין הזה הוא לא אפס, הגדרתו כ- nil מבטלת את הבחירה בסמן ומסתירה את חלון המידע. המאפיין הזה ניתן למדידה באמצעות KVO.
- (BOOL) trafficEnabled [read, write, assign] |
המדיניות הזו קובעת אם המפה תשלוף נתוני תנועה, אם הם זמינים.
בכפוף לזמינות של נתוני תנועה. ברירת המחדל היא 'לא'.
- (GMSMapViewType) mapType [read, write, assign] |
המדיניות הזו קובעת את סוג אריחי המפה שרוצים להציג.
ברירת המחדל היא kGMSTypeNormal.
- (GMSMapStyle*) mapStyle [read, write, assign] |
שליטה בסגנון המפה.
MapStyle אינו אפסי יחול רק אם mapType הוא Normal.
- (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] |
המדיניות הזו מגדירה אם מפות פנים יוצגו, במקומות שבהם הן זמינות.
ברירת המחדל היא 'כן'.
אם ההגדרה היא 'לא', ייתכן שמטמון של נתונים מבפנים יימחק לצמיתות וכל קומה שנבחרה על ידי משתמש הקצה תאופס.
- (GMSIndoorDisplay*) indoorDisplay [read, assign] |
מקבל את המכונה של GMSIndoorDisplay, שמאפשרת לצפות בהיבטים של תצוגת נתונים פנימית או לשלוט בהם.
- (GMSUISettings*) הגדרות [read, assign] |
מקבל את האובייקט GMSUISettings, שקובע את הגדרות ממשק המשתמש של המפה.
- (UIEdgeInsets) מרווח פנימי [read, write, assign] |
ההגדרה קובעת את האזור 'הגלוי' של התצוגה.
כדי ליצור אזור מסביב לקצה התצוגה, מוסיפים מרווחים פנימיים. האזור הזה יכיל נתוני מפה ולא יכלול פקדים של ממשק המשתמש.
אם המרווח הפנימי לא מאוזן, המרכז החזותי של התצוגה יזוז בהתאם. המרווח ישפיע גם על המאפיין projection
, כך שהאזור הגלוי לא יכלול את אזור המרווח הפנימי. פונקציות FitToBounds GMSCameraUpdate יבטיחו שהמערכת תביא בחשבון גם את המרווח הפנימי הזה וגם את המרווח הפנימי המבוקש.
המאפיין הזה עשוי להיות מונפש בבלוק אנימציה שמבוסס על UIView.
- (GMSMapViewPaddingAdjustmentBehavior) paddingAdjustmentBehavior [read, write, assign] אל |
ההגדרה קובעת איך מוסיפים גבולות של אזורים בטוחים לערכי המרווח הפנימי.
כמו מרווח פנימי, פקדי מיקום במפה שנמצאים בתוך האזור הבטוח כמו המצפן, לחצן המיקום שלי ובוחר הקומה באזור הבטוח של המכשיר.
ברירת המחדל היא kGMSMapViewPaddingAdjustmentBehaviorNone.
- (BOOL) accessibilityElementsHidden [read, write, assign]
|
ברירת המחדל היא 'כן'.
אם הערך מוגדר 'לא', GMSMapView ייצור רכיבי נגישות לאובייקטים בשכבת-על, כמו GMSMarker ו-GMSPolyline.
המאפיין הזה פועל לפי הפרוטוקול הרשמי של UIAccessibility, מלבד ערך ברירת המחדל YES (כן).
- (GMSMapLayer*) שכבה [read, retain] |
רכיב גישה לסוג CALayer המותאם אישית שמשמש לשכבה.
- (GMSFrameRate) preferredFrameRate [read, write, assign] |
ההגדרה קובעת את קצב הפריימים של הרינדור.
ערך ברירת המחדל הוא kGMSFrameRateMinimum.
- (GMSCoordinateBounds*) cameraTargetBounds [read, write, assign] |
אם לא אפס, מגביל את יעד המצלמה כך שהתנועות לא יגרמו לו לצאת מהגבולות שצוינו.
- (GMSMapCapabilityFlags) mapCapabilities [read, assign] |
כל היכולות של מצב זמינות לפי תנאים (תלויות ב-mapID או בהגדרות מפה אחרות) שזמינות כרגע.
לא כולל יכולות שזמינות תמיד.
- (מזהה IBOutlet<GMSMapViewNavigationUIDelegate>) navigationUIDelegate [read, write, assign] |
נציג של GMSMapView שמקבל קריאות חוזרות (callback) עבור אירועי ניווט בממשק המשתמש.
- (BOOL) navigationEnabled [read, write, assign] |
האם פונקציונליות הניווט מופעלת עבור המפה הזו.
אם האפשרות 'כן' היא, ניתן להציג במפה מסלולים ומסלולים מפורטים, המצלמה יכולה להיכנס למצב הבא ולחצן המרכז מחדש יופיע כשהמצלמה לא עוקבת אחרי מיקום המכשיר.
אם המשתמש לא הביע הסכמה לתנאים ולהגבלות של ניווט Google, להגדרת המאפיין הזה לא תהיה השפעה. כדי להציג את תיבת הדו-שיח של התנאים וההגבלות, צריך לעיין בשיטות ב-GMSNavigationServices.
- (GMSNavigator*) navigator [read, assign] |
ניווט עבור GMSMapView זה, שמאפשר לבקש מסלולים ולהתחיל לקבל מסלול מפורט.
אם המשתמש לא אישר את התנאים וההגבלות של ניווט Google, הערך יהיה אפס. כדי להציג את תיבת הדו-שיח של התנאים וההגבלות, צריך לעיין בשיטות ב-GMSNavigationServices.
- (GMSRoadSnappedLocationProvider*) roadSnappedLocationProvider [read, assign] |
מאפשר הרשמה לעדכוני מיקום מוצמדים.
אם המשתמש לא אישר את התנאים וההגבלות של ניווט Google, הערך יהיה אפס. כדי להציג את תיבת הדו-שיח של התנאים וההגבלות, צריך לעיין בשיטות ב-GMSNavigationServices.
- (GMSLocationSimulator*) locationSimulator [read, assign] |
ההגדרה מאפשרת לדמות את מיקום המכשיר.
המיקום בסימולציה משפיע על מיקום השבשבת במפה, על ההתקדמות במסלול פנייה אחר פנייה ועל העדכונים שסופקו על ידי ספק המיקום.
אם המשתמש לא אישר את התנאים וההגבלות של ניווט Google, הערך יהיה אפס. כדי להציג את תיבת הדו-שיח של התנאים וההגבלות, צריך לעיין בשיטות ב-GMSNavigationServices.
- (GMSNavigationCameraMode) cameraMode [read, write, assign] |
מצב המצלמה שקובע את ההתנהגות שלה כשהמאפיין navigationEnabled מוגדר ל-YES.
המצבים הזמינים מפורטים בכתובת GMSNavigationCameraMode
.
- (GMSNavigationCameraPerspective) followingPerspective [read, write, assign] |
נקודת המבט של המצלמה שתשמש למעקב אחר מיקום המכשיר.
כדי שהפרספקטיבה הזו תיכנס לתוקף, יש להגדיר את המאפיין navigationEnabled
כ'כן' וצריך להגדיר את cameraMode
כ-GMSNavigationמצלמותModeFollowing.
- (GMSNavigationTravelMode) travelMode [read, write, assign] |
מצב הנסיעה שקובע את סוג המסלולים שיאוחזרו והדרך שבה נקבע מסלול המכשיר.
במצב נהיגה, המסלול של המכשיר מבוסס על כיוון התנועה, ובמצב רכיבה על אופניים או הליכה המסלול מבוסס על כיוון המצפן של המכשיר. קורס המכשיר מיוצג על ידי הכיוון של סמן המיקום של המכשיר ומדווח על ידי GMSRoadSnappedLocationProvider.
– (GMSNavigationLightingMode) lightingMode [read, write, assign] |
מצב התאורה קובע באיזו ערכת צבעים להשתמש להצגת המפה.
הוא משמש גם לקביעת צבעי ברירת המחדל של רכיבים שונים בממשק.
- (BOOL) shouldDisplaySpeedLimit [read, write, assign] |
המדיניות הזו קובעת אם מגבלת המהירות תוצג כשההנחיה פעילה והנתונים על מגבלת המהירות זמינים.
ערך ברירת המחדל הוא NO.
- (BOOL) shouldDisplaySpeedometer [read, write, assign] |
ההגדרה קובעת אם סמל מד המהירות מוצג.
כשהאפשרות מופעלת, יוצג סמל של מד מהירות שמציין את מהירות הרכב בפינה התחתונה במהלך ההנחיה. כשקיימים נתונים מהימנים לגבי מגבלת המהירות, סמל מגבלת המהירות מופיע גם הוא ומוצמד אליו סמל מד המהירות. לסמל של מד המהירות יכולים להיות צבעים שונים של הטקסט והרקע, בהתאם לחומרת ההתראה על המהירות.
אם הלחצן 'מרכוז מחדש' מופעל, מגבלת המהירות וסמל מד המהירות יוסתרו באופן זמני כשיוצג הלחצן 'מרכז העזרה'.
- (UILayoutGuide*) navigationHeaderLayoutGuide [read, assign] |
המלבן שמכוסה על ידי כותרת הניווט.
אם הכותרת מוסתרת, הגובה הוא אפס.
- (UILayoutGuide*) navigationFooterLayoutGuide [read, assign] |
המלבן שמכוסה על ידי הכותרת התחתונה של הניווט.
אם הכותרת התחתונה מוסתרת, הגובה הוא אפס.
- (GMSNavigationRouteCalloutFormat) routeCalloutFormat [read, write, assign] |
המדיניות קובעת באיזה פורמט של יתרונות מרכזיים של המסלול (ברירת מחדל, זמן או מרחק) להשתמש.
- (צף) followingZoomLevel [read, write, assign] |
רמה מותאמת אישית של מרחק התצוגה במהלך הניווט.
הגדרת הערך הזה תבטל את רמת הזום המוגדרת כברירת מחדל ב-SDK של הניווט כשהמצלמה עוקבת אחרי מיקום המכשיר (כלומר, cameraMode
שווה GMSNavigationCameraModeFollowing
). אם אין שינוי מרחק התצוגה, ניתן להגדיר את הערך ל-GMSNavigationNoFollowingZoomLevel
.
- (GMSRoadSnappedLocationProvider*) roadSnappedMyLocationSource [read, write, assign] |
מגדיר את ספק המיקום שלי לתצוגת מפה זו.
בדרך כלל הנקודה ועיגול הדיוק של 'המיקום שלי' בתצוגת מפה מונעים על ידי המיקום של המכשיר בפועל. הגדרת המאפיין הזה תגרום לכך שהנקודה ומעגל הדיוק של 'המיקום שלי' יחושבו על ידי המיקום שתועד דרך ספק המיקום הנתון במקום זאת. כדי לחזור להתנהגות הרגילה, צריך להגדיר את המאפיין הזה כ-n.
אין לכך השפעה כשהתכונה navigationEnabled
מופעלת על תצוגת המפה הזו.