GMSPanoramaView 類別參考資料

GMSPanoramaView 類別參考資料

總覽

全景相片是用來顯示「街景服務」圖像。

其應透過 [[GMSPanoramaView alloc] initWithFrame:] 建構,並在初始化後設定。

所有屬性和方法皆應在主執行緒上存取,類似於所有 UIKit 物件。而 GMSPanoramaViewDelegate 也將只由主執行緒呼叫。

沒有可見的全景 (例如載入中或日後將全景設為 nil) 時,會顯示這個 view 的 backgroundColor。不支援 backgroundColor 的 Alpha 顏色。

公開成員函式

(無效)- setAllGesturesEnabled:
 設定是否要啟用所有手勢 (預設) 或停用。
(無效)- animateToCamera:animationDuration:
 將此 GMSPanoramaView 的相機以 cameraduration 動畫 (以秒為單位)。
(無效)- 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 的便利建構函式,可供搜尋並顯示GMSPanoramacoordinate 附近。
(執行個體類型)+ PanoramaramaWithFrame:nearCoordinate:radius:
 類似全景 WithFrame:nearCoordinate:但允許指定 coordinate 周圍的搜尋半徑 (公尺)。
(執行個體類型)+ PanoramaramaWithFrame:nearCoordinate:source:
 GMSPanoramaView 的便利建構函式,可供搜尋並顯示GMSPanoramacoordinate 附近。
(執行個體類型)+ PanoramaramaWithFrame:nearCoordinate:radius:source:
 GMSPanoramaView 的便利建構函式,可供搜尋並顯示GMSPanoramacoordinate 附近。

屬性

GMSPanorama *全景
 要顯示的全景;設定後會轉換為新的全景。
IBOutlet ID
< GMSPanoramaViewDelegate >
委派
 GMSPanoramaView 委派。
布林值螢幕方向
 控制是否要啟用方向手勢 (預設) 或停用。
布林值變焦手勢
 控制是否要啟用縮放手勢 (預設) 或停用。
布林值導航手勢
 控制是否要啟用導航手勢 (預設) 或停用。
布林值導覽連結已隱藏
 控制可輕觸的導覽連結是否為隱藏狀態 (預設)。
布林值streetNamesHidden
 控制是否要隱藏或顯示街道名稱疊加層 (預設)。
GMSPanoramaCamera *相機
 控制全景相機的相機。
GMSPanoramaLayer *圖層
 用於圖層的自訂 CALayer 類型的存取子。

成員函式說明文件

- (void) setAllGesturesEnabled: (布林值) 已啟用

設定是否要啟用所有手勢 (預設) 或停用。

這不會限制相機的程式輔助動作或全景的控制。

- (void) animateToCamera: (GMSPanoramaCamera *) 相機
動畫時間長度: (NSTimeInterval) duration

將此 GMSPanoramaView 的相機以 cameraduration 動畫 (以秒為單位)。

- (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 大約等於目前的 GMSPanoramaCamera

+ (執行個體類型)全景 WithFrame: (問題) 框架
附近的協調中心: (CLLocationCoordinate2D) 協調中心

GMSPanoramaView 的便利建構函式,可供搜尋並顯示GMSPanoramacoordinate 附近。

此步驟將執行與 MoveNearCoordinate: 類似的動作,並會呼叫相同的委派方法。

+ (執行個體類型)全景 WithFrame: (問題) 框架
附近的協調中心: (CLLocationCoordinate2D) 座標
半徑: (NSUInteger) radius:半徑

類似全景 WithFrame:nearCoordinate:但允許指定 coordinate 周圍的搜尋半徑 (公尺)。

+ (執行個體類型)全景 WithFrame: (問題) 框架
附近的協調中心: (CLLocationCoordinate2D) 座標
資料來源: (GMSPanoramaSource) 來源

GMSPanoramaView 的便利建構函式,可供搜尋並顯示GMSPanoramacoordinate 附近。

此動作將移動與 MoveNearCoordinate:source 類似,並且會呼叫相同的委派方法。

這個 API 尚處於實驗階段,不一定每次都會按來源篩選。

+ (執行個體類型)全景 WithFrame: (問題) 框架
附近的協調中心: (CLLocationCoordinate2D) 座標
半徑: (NSUInteger) 半徑
資料來源: (GMSPanoramaSource) 來源

GMSPanoramaView 的便利建構函式,可供搜尋並顯示GMSPanoramacoordinate 附近。

此步驟會執行與 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 類型的存取子。