總覽
全景相片是用來顯示「街景服務」圖像。
其應透過 [[GMSPanoramaView alloc] initWithFrame:] 建構,並在初始化後設定。
所有屬性和方法皆應在主執行緒上存取,類似於所有 UIKit 物件。而 GMSPanoramaViewDelegate 也將只由主執行緒呼叫。
沒有可見的全景 (例如載入中或日後將全景設為 nil) 時,會顯示這個 view 的 backgroundColor。不支援 backgroundColor 的 Alpha 顏色。
公開成員函式 | |
(無效) | - setAllGesturesEnabled: |
設定是否要啟用所有手勢 (預設) 或停用。 | |
(無效) | - animateToCamera:animationDuration: |
將此 GMSPanoramaView 的相機以 camera 為 duration 動畫 (以秒為單位)。 | |
(無效) | - updateCamera:animationDuration: |
依據 cameraUpdate (以 duration 指定,以秒為單位) 修改相機。 | |
(無效) | - moveNearCoordinate: |
要求coordinate 附近的全景。 | |
(無效) | - moveNearCoordinate:radius: |
類似於 MoveNearCoordinate:但允許指定 coordinate 附近的搜尋半徑 (公尺)。 | |
(無效) | - moveNearCoordinate:source: |
類似於 MoveNearCoordinate:但允許指定 coordinate 附近的來源。 | |
(無效) | - moveNearCoordinate:radius:source: |
類似於 MoveNearCoordinate:但允許指定 coordinate 和來源周圍的搜尋半徑 (公尺)。 | |
(無效) | - moveToPanoramaID: |
使用 panoramaID 要求全景。 | |
(CGPoint) | - pointForOrientation: |
如果是目前的檢視畫面,則傳回 orientation 指向的螢幕點。 | |
(GMSOrientation) | - orientationForPoint: |
為這個檢視畫面的點,傳回指向該螢幕位置的現有相機方向。 | |
靜態公開成員函式 | |
(執行個體類型) | + PanoramaramaWithFrame:nearCoordinate: |
GMSPanoramaView 的便利建構函式,可供搜尋並顯示GMSPanorama 在 coordinate 附近。 | |
(執行個體類型) | + PanoramaramaWithFrame:nearCoordinate:radius: |
類似全景 WithFrame:nearCoordinate:但允許指定 coordinate 周圍的搜尋半徑 (公尺)。 | |
(執行個體類型) | + PanoramaramaWithFrame:nearCoordinate:source: |
GMSPanoramaView 的便利建構函式,可供搜尋並顯示GMSPanorama 在 coordinate 附近。 | |
(執行個體類型) | + PanoramaramaWithFrame:nearCoordinate:radius:source: |
GMSPanoramaView 的便利建構函式,可供搜尋並顯示GMSPanorama 在 coordinate 附近。 | |
屬性 | |
GMSPanorama * | 全景 |
要顯示的全景;設定後會轉換為新的全景。 | |
IBOutlet ID < GMSPanoramaViewDelegate > | 委派 |
GMSPanoramaView 委派。 | |
布林值 | 螢幕方向 |
控制是否要啟用方向手勢 (預設) 或停用。 | |
布林值 | 變焦手勢 |
控制是否要啟用縮放手勢 (預設) 或停用。 | |
布林值 | 導航手勢 |
控制是否要啟用導航手勢 (預設) 或停用。 | |
布林值 | 導覽連結已隱藏 |
控制可輕觸的導覽連結是否為隱藏狀態 (預設)。 | |
布林值 | streetNamesHidden |
控制是否要隱藏或顯示街道名稱疊加層 (預設)。 | |
GMSPanoramaCamera * | 相機 |
控制全景相機的相機。 | |
GMSPanoramaLayer * | 圖層 |
用於圖層的自訂 CALayer 類型的存取子。 |
成員函式說明文件
- (void) setAllGesturesEnabled: | (布林值) | 已啟用 |
設定是否要啟用所有手勢 (預設) 或停用。
這不會限制相機的程式輔助動作或全景的控制。
- (void) animateToCamera: | (GMSPanoramaCamera *) | 相機 | |
動畫時間長度: | (NSTimeInterval) | duration | |
將此 GMSPanoramaView 的相機以 camera
為 duration
動畫 (以秒為單位)。
- (void) updateCamera: | (GMSPanoramaCameraUpdate *) | CameraUpdate | |
動畫時間長度: | (NSTimeInterval) | duration | |
依據 cameraUpdate
(以 duration
指定,以秒為單位) 修改相機。
- (無效) moveNearCoordinate: | (CLLocationCoordinate2D) | 座標 |
要求coordinate
附近的全景。
成功完成全景 ViewView:didMoveToPanorama: 和全景 View:didMoveToPanorama:nearCoordinate: 會傳送至 GMSPanoramaViewDelegate。
錯誤全景 ViewView:error:onMoveNearCoordinate: 將會傳送。
重複呼叫 MoveNearCoordinate:導致先前的待處理 (未完成) 轉場取消,只有前一組 MoveNearCoordinate: 和 MoveToPanoramaId: 將繼續並產生事件。
- (無效) moveNearCoordinate: | (CLLocationCoordinate2D) | 座標 | |
半徑: | (NSUInteger) | radius:半徑 | |
類似於 MoveNearCoordinate:但允許指定 coordinate
附近的搜尋半徑 (公尺)。
- (無效) moveNearCoordinate: | (CLLocationCoordinate2D) | 座標 | |
資料來源: | (GMSPanoramaSource) | 來源 | |
類似於 MoveNearCoordinate:但允許指定 coordinate
附近的來源。
這個 API 尚處於實驗階段,不一定每次都會按來源篩選。
- (無效) moveNearCoordinate: | (CLLocationCoordinate2D) | 座標 | |
半徑: | (NSUInteger) | 半徑 | |
資料來源: | (GMSPanoramaSource) | 來源 | |
類似於 MoveNearCoordinate:但允許指定 coordinate
和來源周圍的搜尋半徑 (公尺)。
這個 API 尚處於實驗階段,不一定每次都會按來源篩選。
- (無效) moveToPanoramaID: | (NSString *) | PanoramaramaID |
使用 panoramaID
要求全景。
成功完成全景 ViewView:didMoveToPanorama: 後會傳送至 GMSPanoramaViewDelegate。
發生錯誤的 ViewView:error:onMoveToPanoramaID: 將傳送。
重複呼叫 MoveToPanoramaID:會導致先前的待處理 (未完成) 轉場取消,只有最近一次的 MoveNearCoordinate: 和 MoveToPanoramaId: 將會繼續並產生事件。
僅支援從 Google Maps SDK for iOS 取得的全景 ID。
- (CGPoint) pointForOrientation: | (GMSOrientation) | 方向 |
如果是目前的檢視畫面,則傳回 orientation
指向的螢幕點。
這個值可能會超出正向的前方,且方向朝向前方。
結果中會包含與螢幕方向有關的相機方向 (NaN),其中隱含的螢幕點會在螢幕方向朝向相機時呈現負的距離。
- (GMSOrientation) orientationForPoint: | (CGPoint) | 點 |
為這個檢視畫面的點,傳回指向該螢幕位置的現有相機方向。
在這個檢視畫面的中央,傳回的 GMSOrientation 大約等於目前的 GMSPanoramaCamera。
+ (執行個體類型)全景 WithFrame: | (問題) | 框架 | |
附近的協調中心: | (CLLocationCoordinate2D) | 協調中心 | |
GMSPanoramaView 的便利建構函式,可供搜尋並顯示GMSPanorama 在 coordinate
附近。
此步驟將執行與 MoveNearCoordinate: 類似的動作,並會呼叫相同的委派方法。
+ (執行個體類型)全景 WithFrame: | (問題) | 框架 | |
附近的協調中心: | (CLLocationCoordinate2D) | 座標 | |
半徑: | (NSUInteger) | radius:半徑 | |
類似全景 WithFrame:nearCoordinate:但允許指定 coordinate
周圍的搜尋半徑 (公尺)。
+ (執行個體類型)全景 WithFrame: | (問題) | 框架 | |
附近的協調中心: | (CLLocationCoordinate2D) | 座標 | |
資料來源: | (GMSPanoramaSource) | 來源 | |
GMSPanoramaView 的便利建構函式,可供搜尋並顯示GMSPanorama 在 coordinate
附近。
此動作將移動與 MoveNearCoordinate:source 類似,並且會呼叫相同的委派方法。
這個 API 尚處於實驗階段,不一定每次都會按來源篩選。
+ (執行個體類型)全景 WithFrame: | (問題) | 框架 | |
附近的協調中心: | (CLLocationCoordinate2D) | 座標 | |
半徑: | (NSUInteger) | 半徑 | |
資料來源: | (GMSPanoramaSource) | 來源 | |
GMSPanoramaView 的便利建構函式,可供搜尋並顯示GMSPanorama 在 coordinate
附近。
此步驟會執行與 MoveNearCoordinate:radius:source 類似的動作,並呼叫相同的委派方法。
這個 API 尚處於實驗階段,不一定每次都會按來源篩選。
屬性說明文件
- (GMSPanorama*) 全景 [read, write, assign] |
要顯示的全景;設定後會轉換為新的全景。
此動畫為動畫,但初始全景除外。
設為 nil 即可清除檢視畫面。
- (IBOutlet id<GMSPanoramaViewDelegate>) 委派 [read, write, assign] |
GMSPanoramaView 委派。
- (BOOL) 螢幕方向手勢 [read, write, assign] |
控制是否要啟用方向手勢 (預設) 或停用。
啟用後,使用者可能會利用手勢來改變相機的方向。
這不會限制相機的程式輔助動作。
- (布林值) zoomGestures [read, write, assign] |
控制是否要啟用縮放手勢 (預設) 或停用。
啟用後,使用者可能會撥動來縮放相機。
這不會限制相機的程式輔助動作。
- (BOOL) 導航手勢 [read, write, assign] |
控制是否要啟用導航手勢 (預設) 或停用。
啟用後,使用者只要輕觸一下導覽連結,或輕觸兩下視圖,即可變更全景。
這不會限制全景的程式輔助控制。
- (布林值) navigationLinks 已隱藏 [read, write, assign] |
控制可輕觸的導覽連結是否為隱藏狀態 (預設)。
無法輕觸隱藏的導覽連結。
- (BOOL) streetNamesHidden [read, write, assign] |
控制是否要隱藏或顯示街道名稱疊加層 (預設)。
- (GMSPanoramaCamera*) 相機 [read, write, assign] |
控制全景相機的相機。
如果您在這裡設定新的相機,則會跳到新的相機,而且沒有動畫。
- (GMSPanoramaLayer*) 圖層 [read, retain] |
用於圖層的自訂 CALayer 類型的存取子。