סקירה כללית
תמונת פנורמה משמשת להצגת תמונות של Street View.
יש לבנות אותו באמצעות [[GMSPanoramaView alloc] initWithFrame:] ולהגדיר אותו לאחר האתחול.
יש לגשת לכל המאפיינים והשיטות ב-thread הראשי, בדומה לכל האובייקטים של UIKit. גם השיטות GMSPanoramaViewDelegate ייקראו שוב רק ל-thread הראשי.
צבע הרקע של תצוגה זו מוצג כאשר אין פנורמה גלויה, למשל בזמן הטעינה או אם הפנורמה מוגדרת מאוחר יותר כאפס. אין תמיכה בצבע האלפא של backgroundColor.
פונקציות של חברי ציבור | |
| (void) | - setAllentsEnabled: |
| הגדרת ההעדפה להפעלה (ברירת מחדל) או להשבתה של כל התנועות. | |
| (void) | - animateTocamera:animationDuration: |
יוצרת אנימציה של המצלמה של GMSPanoramaView ל-camera, מעל duration (מצוין בשניות). | |
| (void) | - updateCamera:animationDuration: |
שינוי המצלמה בהתאם לcameraUpdate, מעל duration (מצוין בשניות). | |
| (void) | - moveNearcoordinate: |
מבקש תמונת פנורמה ליד coordinate. | |
| (void) | - moveNearcoordinate:radius: |
דומה ל-moveNear בתצוגה: אך מאפשר לציין רדיוס חיפוש (מטרים) סביב coordinate. | |
| (void) | - moveNearcoordinate:source: |
דומה ל-moveNear בתצוגה: אך מאפשר לציין מקור ליד coordinate. | |
| (void) | - moveNearCoordinate:radius:source: |
דומה ל-moveNear בתצוגה: אך מאפשר לציין רדיוס חיפוש (מטרים) סביב coordinate ומקור. | |
| (void) | - moveToPanoramaID: |
מבקש תמונת פנורמה עם panoramaID. | |
| (CGPoint) | – pointForOrientation: |
כדי להציג את התצוגה הנוכחית, מחזירים את הנקודה שדרכה orientation מפנה במסך. | |
| (GMSOrientation) | - orientationForPoint: |
| בהינתן נקודה בתצוגה זו, מחזירה את כיוון המצלמה הנוכחי שמצביע דרך אותו מיקום מסך. | |
פונקציות סטטיות של חברים ציבוריים | |
| (instancetype) | + panoramaWithFrame:nearcoordinate: |
בנאי נוחות של GMSPanoramaView, שמחפש ומציג GMSPanorama ליד coordinate. | |
| (instancetype) | + panoramaWithFrame:nearCoordinate:radius: |
דומה ל-פנורמהWithFrame:near בתצוגה: אך מאפשר לציין רדיוס חיפוש (מטרים) סביב coordinate. | |
| (instancetype) | + panoramaWithFrame:nearCoordinate:source: |
בנאי נוחות של GMSPanoramaView, שמחפש ומציג GMSPanorama ליד coordinate. | |
| (instancetype) | + panoramaWithFrame:nearCoordinate:radius:source: |
בנאי נוחות של GMSPanoramaView, שמחפש ומציג GMSPanorama ליד coordinate. | |
נכסים | |
| GMSPanorama * | פנורמה |
| הפנורמה לתצוגה; הגדרתה תהפוך לפנורמה חדשה. | |
| מזהה IBOutlet < GMSPanoramaViewDelegate > | להאציל סמכויות |
| משתמש ב-GMSPanoramaView. | |
| בול (BOOL) | orientationGestures |
| קובעת אם תנועות הכיוון מופעלות (ברירת מחדל) או מושבתות. | |
| בול (BOOL) | zoomGestures |
| קובעת אם תנועות לשינוי מרחק התצוגה מופעלות (ברירת מחדל) או מושבתות. | |
| בול (BOOL) | navigationGestures |
| קובעת אם תנועות ניווט מופעלות (ברירת מחדל) או מושבתות. | |
| בול (BOOL) | navigationLinksHidden |
| המדיניות הזו קובעת אם קישורי הניווט שניתן להקיש עליהם מוסתרים או גלויים (ברירת מחדל). | |
| בול (BOOL) | streetNamesHidden |
| המדיניות הזו קובעת אם שכבות-העל של שם הרחוב מוסתרות או גלויות (ברירת מחדל). | |
| GMSPanoramaCamera * | מצלמה |
| שולטת במצלמה של הפנורמה. | |
| GMSPanoramaLayer * | שכבה |
| רכיב גישה לסוג CALayer המותאם אישית שמשמש לשכבה. | |
תיעוד לגבי פונקציות חברים
| - (ריק) setAllGesturesEnabled: | (BOOL) | מופעלת |
הגדרת ההעדפה להפעלה (ברירת מחדל) או להשבתה של כל התנועות.
אין הגבלה על התנועה הפרוגרמטית של המצלמה או על השליטה בפנורמה.
| - (ריק) הנפשהלמצלמה: | (GMSPanoramaCamera *) | מצלמה | |
| משך האנימציה: | (NSTimeInterval) | duration | |
יוצרת אנימציה של המצלמה של GMSPanoramaView ל-camera, מעל duration (מצוין בשניות).
| - (לא בתוקף) update Camera: | (GMSPanoramaCameraUpdate *) | cameraUpdate | |
| משך האנימציה: | (NSTimeInterval) | duration | |
שינוי המצלמה בהתאם לcameraUpdate, מעל duration (מצוין בשניות).
| - (בטל) moveNearcoordinate: | (CLLocationCoordinate2D) | קואורדינטות |
מבקש תמונת פנורמה ליד coordinate.
לאחר סיום הסיום, PanView:didMoveToPanorama: and PanView:didMoveToPanorama:nearradius: יישלחו אל GMSPanoramaViewDelegate.
בעת שגיאה פנורמיתView:error:onMoveNearcoordinate: תישלח.
קריאות חוזרות ל-moveNearcoordinate: ביטול של המעברים הקודמים שהיו בהמתנה (שלא הושלמו) – רק המעבר האחרון ב-moveNear בתצוגה: ו-moveToPanoramaId: ימשיכו להתבצע.
| - (בטל) moveNearcoordinate: | (CLLocationCoordinate2D) | קואורדינטות | |
| רדיוס: | (NSUInteger) | radius | |
דומה ל-moveNear בתצוגה: אך מאפשר לציין רדיוס חיפוש (מטרים) סביב coordinate.
| - (בטל) moveNearcoordinate: | (CLLocationCoordinate2D) | קואורדינטות | |
| מקור: | (GMSPanoramaSource). | מקור | |
דומה ל-moveNear בתצוגה: אך מאפשר לציין מקור ליד coordinate.
ה-API הזה ניסיוני ויכול להיות שלא תמיד יסנן אותו לפי מקור.
| - (בטל) moveNearcoordinate: | (CLLocationCoordinate2D) | קואורדינטות | |
| רדיוס: | (NSUInteger) | רדיוס | |
| מקור: | (GMSPanoramaSource). | מקור | |
דומה ל-moveNear בתצוגה: אך מאפשר לציין רדיוס חיפוש (מטרים) סביב coordinate ומקור.
ה-API הזה ניסיוני ויכול להיות שלא תמיד יסנן אותו לפי מקור.
| - (בטל) moveToPanoramaID: | (NSString *) | panoramaID |
מבקש תמונת פנורמה עם panoramaID.
לאחר הסיום, PanView:didMoveToPanorama: יישלח אל GMSPanoramaViewDelegate.
בעת שגיאה פנורמיתView:error:onMoveToPanoramaID: יישלח.
קריאות חוזרות ל-moveToPanoramaID: גורמות לביטול ההעברות שבהמתנה (שלא הושלמו) -- רק ההעברה האחרונה שלmoveNearandroid: ו-moveToPanoramaId: תתבצע.
המערכת תומכת רק במזהי פנורמה שהתקבלו מה-SDK של מפות Google ל-iOS.
| – (CGPoint) pointForOrientation: | (GMSOrientation) | כיוון |
כדי להציג את התצוגה הנוכחית, מחזירים את הנקודה שדרכה orientation מפנה במסך.
הערך הזה עשוי להיות מחוץ לתצוגה עבור כיוונים קדימה, שרחוקים מספיק ישר קדימה.
התוצאה תכלול ערכי NaN לכיוונים של המצלמה, שמרחקים מהתצוגה, כאשר נקודת המסך המשתמעת מקבלת מרחק שלילי מהמצלמה בכיוון התצוגה.
| – (GMSOrientation) orientationForPoint: | (CGPoint) | נקודה |
בהינתן נקודה בתצוגה זו, מחזירה את כיוון המצלמה הנוכחי שמצביע דרך אותו מיקום מסך.
במרכז התצוגה הזו, ה-GMSOrientation שיוחזר יהיה בערך שווה לזה של ה-GMSPanoramaCamera הנוכחית.
| + (instancetype) closedWithFrame: | (CGRect) | מסגרת | |
| ליד: | (CLLocationCoordinate2D) | קואורדינטות | |
בנאי נוחות של GMSPanoramaView, שמחפש ומציג GMSPanorama ליד coordinate.
הפעולה הזו מבצעת פעולה דומה לזו שלmoveNearcoordinate:, והיא מפעילה את אותן שיטות האצלה.
| + (instancetype) closedWithFrame: | (CGRect) | מסגרת | |
| ליד: | (CLLocationCoordinate2D) | קואורדינטות | |
| רדיוס: | (NSUInteger) | radius | |
דומה ל-פנורמהWithFrame:near בתצוגה: אך מאפשר לציין רדיוס חיפוש (מטרים) סביב coordinate.
| + (instancetype) closedWithFrame: | (CGRect) | מסגרת | |
| ליד: | (CLLocationCoordinate2D) | קואורדינטות | |
| מקור: | (GMSPanoramaSource). | מקור | |
בנאי נוחות של GMSPanoramaView, שמחפש ומציג GMSPanorama ליד coordinate.
הפעולה הזו מבצעת פעולה דומה לזו שלmoveNearcoordinate:source, והיא מפעילה את אותן שיטות האצלה.
ה-API הזה ניסיוני ויכול להיות שלא תמיד יסנן אותו לפי מקור.
| + (instancetype) closedWithFrame: | (CGRect) | מסגרת | |
| ליד: | (CLLocationCoordinate2D) | קואורדינטות | |
| רדיוס: | (NSUInteger) | רדיוס | |
| מקור: | (GMSPanoramaSource). | מקור | |
בנאי נוחות של GMSPanoramaView, שמחפש ומציג GMSPanorama ליד coordinate.
הפעולה הזו מבצעת פעולה דומה לזו שלmoveNearמידת הרדיוס:source, והיא תפעיל את אותן שיטות האצלה.
ה-API הזה ניסיוני ויכול להיות שלא תמיד יסנן אותו לפי מקור.
מסמכי תיעוד לגבי הנכס
- (GMSPanorama*) פנורמה [read, write, assign] |
הפנורמה לתצוגה; הגדרתה תהפוך לפנורמה חדשה.
הוא מונפש, מלבד הפנורמה הראשונית.
ניתן להגדיר לערך אפס כדי לנקות את התצוגה.
- (מזהה IBOutlet id<GMSPanoramaViewDelegate>) נציג [read, write, assign] |
משתמש ב-GMSPanoramaView.
- (BOOL) orientationGestures [read, write, assign] |
קובעת אם תנועות הכיוון מופעלות (ברירת מחדל) או מושבתות.
אם ההגדרה הזו מופעלת, המשתמשים יכולים להשתמש בתנועות כדי לשנות את כיוון המצלמה.
ההגדרה הזו לא מגבילה את התנועה הפרוגרמטית של המצלמה.
- (BOOL) zoomGestures [read, write, assign] |
קובעת אם תנועות לשינוי מרחק התצוגה מופעלות (ברירת מחדל) או מושבתות.
אם ההגדרה הזו מופעלת, המשתמשים יכולים לעשות תנועת צביטה כדי לשנות את מרחק התצוגה של המצלמה.
ההגדרה הזו לא מגבילה את התנועה הפרוגרמטית של המצלמה.
- (BOOL) navigationGestures [read, write, assign] |
קובעת אם תנועות ניווט מופעלות (ברירת מחדל) או מושבתות.
אם ההגדרה הזו מופעלת, המשתמשים יכולים להשתמש בהקשה אחת על קישורי הניווט או להקיש הקשה כפולה על התצוגה כדי לעבור בין התמונות הפנורמיות.
העובדה הזו לא מגבילה את השליטה הפרוגרמטית בפנורמה.
- (BOOL) navigationLinksHidden [read, write, assign] |
המדיניות הזו קובעת אם קישורי הניווט שניתן להקיש עליהם מוסתרים או גלויים (ברירת מחדל).
אי אפשר להקיש על קישורי ניווט מוסתרים.
- (BOOL) streetNamesHidden [read, write, assign] |
המדיניות הזו קובעת אם שכבות-העל של שם הרחוב מוסתרות או גלויות (ברירת מחדל).
- (GMSPanoramaCamera*) מצלמה [read, write, assign] |
שולטת במצלמה של הפנורמה.
הגדרת מצלמה חדשה כאן תדלג לערך המצלמה החדש, ללא אנימציה.
- (GMSPanoramaLayer*) שכבה [read, retain] |
רכיב גישה לסוג CALayer המותאם אישית שמשמש לשכבה.