概要
パノラマは、ストリートビュー画像を表示するために使用されます。
[[GMSPanoramaView alloc] initWithFrame:] で作成し、初期化後に設定する必要があります。
すべての UIKit オブジェクトと同様に、すべてのプロパティとメソッドはメインスレッドでアクセスする必要があります。また、GMSPanoramaViewDelegate メソッドも、メインスレッドでのみコールバックされます。
このビューの backgroundColor は、パノラマが表示されていない間(読み込み中やパノラマが後で nil に設定されたときなど)に表示されます。backgroundColor のアルファ カラーはサポートされていません。
パブリック メンバー関数 | |
(void) | - setAllGesturesEnabled: |
すべての操作を有効にするか(デフォルト)無効にするかの設定を設定します。 | |
(void) | - animateToCamera:animationDuration: |
この GMSPanoramaView のカメラを、duration (秒単位で指定)経由で camera にアニメーション化します。 | |
(void) | - updateCamera:animationDuration: |
カメラを duration (秒単位で指定)で cameraUpdate に従って変更します。 | |
(void) | - moveNearCoordinate: |
coordinate 付近のパノラマをリクエストします。 | |
(void) | - moveNearCoordinate:radius: |
MoveNearCoordinate に似ていますが、coordinate を中心とした検索半径(メートル)を指定できます。 | |
(void) | - moveNearCoordinate:source: |
MoveNearCoordinate に似ていますが、coordinate に近いソースを指定できます。 | |
(void) | - moveNearCoordinate:radius:source: |
MoveNearCoordinate と似ていますが、coordinate とソースを中心とする検索半径(メートル)を指定できます。 | |
(void) | - moveToPanoramaID: |
panoramaID のパノラマをリクエストします。 | |
(CGPoint) | - pointForOrientation: |
現在のビューについて、orientation が指すスクリーン ポイントを返します。 | |
(GMSOrientation) | - orientationForPoint: |
このビューの地点を指定すると、その画面の位置をポイントする現在のカメラの向きを返します。 | |
静的パブリック メンバー関数 | |
(instancetype) | + panramaWithFrame:nearCoordinate: |
coordinate の近くにある GMSPanorama を検索して表示する GMSPanoramaView のコンビニエンス コンストラクタ。 | |
(instancetype) | + panoramaWithFrame:nearCoordinate:radius: |
PolishedWithFrame:nearCoordinate: と似ていますが、coordinate を中心とした検索半径(メートル)を指定できます。 | |
(instancetype) | + panoramaWithFrame:nearCoordinate:source: |
coordinate の近くにある GMSPanorama を検索して表示する GMSPanoramaView のコンビニエンス コンストラクタ。 | |
(instancetype) | + panoramaWithFrame:nearCoordinate:radius:source: |
coordinate の近くにある GMSPanorama を検索して表示する GMSPanoramaView のコンビニエンス コンストラクタ。 | |
プロパティ | |
GMSPanorama * | パノラマ |
表示するパノラマ画像。設定すると新しいパノラマ画像に遷移します。 | |
IBOutlet ID < GMSPanoramaViewDelegate > | 委任 |
GMSPanoramaView デリゲート: | |
BOOL | orientationGestures |
向きのジェスチャーを有効にするか(デフォルト)か無効にするかを制御します。 | |
BOOL | zoomGestures |
ズーム操作を有効にする(デフォルト)か無効にするかを制御します。 | |
BOOL | navigationGestures |
ナビゲーション操作を有効にする(デフォルト)か無効にするかを制御します。 | |
BOOL | navigationLinksHidden |
タップ可能なナビゲーション リンクを表示するか、表示するかを制御します(デフォルト)。 | |
BOOL | streetNamesHidden |
道路名のオーバーレイを非表示にするか、表示するかを制御します(デフォルト)。 | |
GMSPanoramaCamera * | camera |
パノラマのカメラを制御します。 | |
GMSPanoramaLayer * | レイヤ |
レイヤに使用されるカスタム CALayer タイプのアクセサー。 |
メンバー関数のドキュメント
- (void)setAllGesturesEnabled: | (BOOL) | 有効 |
すべての操作を有効にするか(デフォルト)無効にするかの設定を設定します。
これにより、カメラやパノラマのプログラムによる移動が制限されることはありません。
-(void)animateToCamera: | (GMSPanoramaCamera *) | camera | |
emojiDuration: | (NSTimeInterval) | duration | |
この GMSPanoramaView のカメラを、duration
(秒単位で指定)経由で camera
にアニメーション化します。
- (void) updateCamera: | (GMSPanoramaCameraUpdate *) | cameraUpdate | |
emojiDuration: | (NSTimeInterval) | duration | |
カメラを duration
(秒単位で指定)で cameraUpdate
に従って変更します。
- (void) moveNearCoordinate: | (CLLocationCoordinate2D) | 座標 |
coordinate
付近のパノラマをリクエストします。
正常に完了すると、PanoramaView:didMoveToPanorama: とパノラマビュー:didMoveToPanorama:nearCoordinate: が GMSPanoramaViewDelegate に送信されます。
エラーが発生すると、ChromeOSView:error:onMoveNearCoordinate: が送信されます。
MoveNearCoordinate: の呼び出しが繰り返されると、前の保留中の(未完了の)遷移がキャンセルされます。その後、moveNearCoordinate: と MoveToPanoramaId: の最新のものだけが続行され、イベントが生成されます。
- (void) moveNearCoordinate: | (CLLocationCoordinate2D) | 座標 | |
radius: | (NSUInteger) | radius | |
MoveNearCoordinate に似ていますが、coordinate
を中心とした検索半径(メートル)を指定できます。
- (void) moveNearCoordinate: | (CLLocationCoordinate2D) | 座標 | |
source: | (GMSPanoramaSource) | 出典 | |
MoveNearCoordinate に似ていますが、coordinate
に近いソースを指定できます。
この API は試験運用版であり、常にソースでフィルタされるとは限りません。
- (void) moveNearCoordinate: | (CLLocationCoordinate2D) | 座標 | |
radius: | (NSUInteger) | 半径 | |
source: | (GMSPanoramaSource) | 出典 | |
MoveNearCoordinate と似ていますが、coordinate
とソースを中心とする検索半径(メートル)を指定できます。
この API は試験運用版であり、常にソースでフィルタされるとは限りません。
- (void) moveToPanoramaID: | (NSString *) | panoramaID |
panoramaID
のパノラマをリクエストします。
正常に完了すると、PanoramaView:didMoveToPanorama: が GMSPanoramaViewDelegate に送信されます。
エラーが発生すると、ChromeOSView:error:onMoveToPanoramaID: が送信されます。
MoveToPanoramaID: の呼び出しを繰り返すと、前の保留中の(未完了の)遷移がキャンセルされます。このとき、MoveNearCoordinate: と moveToPanoramaId: のうち最新のものだけが続行され、イベントが生成されます。
Google Maps SDK for iOS から取得したパノラマ ID のみがサポートされます。
-(CGPoint)pointForOrientation: | (GMSOrientation) | 向き |
現在のビューについて、orientation
が指すスクリーン ポイントを返します。
この値は、直前から十分な距離にある正面向きの場合、ビューの範囲外になることがあります。
結果には、ビューから反対側を指すカメラの向きの NaN が含まれます。この場合、暗黙的な画面ポイントは、向きの方向でカメラからの距離が負のものになります。
-(GMSOrientation)orientationForPoint: | (CGPoint) | 拡張ポイント |
このビューの地点を指定すると、その画面の位置をポイントする現在のカメラの向きを返します。
このビューの中心で、返される GMSOrientation は現在の GMSPanoramaCamera とほぼ同じになります。
+ (instancetype)PanoramaWithFrame: | (CGRect) | フレーム | |
NearCoordinate: | (CLLocationCoordinate2D) | Coordinate | |
coordinate
の近くにある GMSPanorama を検索して表示する GMSPanoramaView のコンビニエンス コンストラクタ。
これは、moveNearCoordinate: と同様のアクションを実行し、同じデリゲート メソッドを呼び出します。
+ (instancetype)PanoramaWithFrame: | (CGRect) | フレーム | |
NearCoordinate: | (CLLocationCoordinate2D) | 座標 | |
radius: | (NSUInteger) | radius | |
PolishedWithFrame:nearCoordinate: と似ていますが、coordinate
を中心とした検索半径(メートル)を指定できます。
+ (instancetype)PanoramaWithFrame: | (CGRect) | フレーム | |
NearCoordinate: | (CLLocationCoordinate2D) | 座標 | |
source: | (GMSPanoramaSource) | 出典 | |
coordinate
の近くにある GMSPanorama を検索して表示する GMSPanoramaView のコンビニエンス コンストラクタ。
これは、moveNearCoordinate:source と同様のアクションを実行し、同じデリゲート メソッドを呼び出します。
この API は試験運用版であり、常にソースでフィルタされるとは限りません。
+ (instancetype)PanoramaWithFrame: | (CGRect) | フレーム | |
NearCoordinate: | (CLLocationCoordinate2D) | 座標 | |
radius: | (NSUInteger) | 半径 | |
source: | (GMSPanoramaSource) | 出典 | |
coordinate
の近くにある GMSPanorama を検索して表示する GMSPanoramaView のコンビニエンス コンストラクタ。
これは、moveNearCoordinate:radius:source の場合と同様のアクションを実行し、同じデリゲート メソッドを呼び出します。
この API は試験運用版であり、常にソースでフィルタされるとは限りません。
プロパティのドキュメント
- (GMSPanorama*) パノラマ [read, write, assign] |
表示するパノラマ画像。設定すると新しいパノラマ画像に遷移します。
最初のパノラマを除き、アニメーションが表示されます。
nil に設定すると、ビューをクリアできます。
- (IBOutlet ID<GMSPanoramaViewDelegate>)delegate [read, write, assign] |
GMSPanoramaView デリゲート:
- (BOOL)orientationGestures [read, write, assign] |
向きのジェスチャーを有効にするか(デフォルト)か無効にするかを制御します。
有効にした場合、ユーザーはジェスチャーを使用してカメラの向きを変更できます。
この場合、カメラによるプログラムによる移動は制限されません。
- (BOOL)zoomGestures [read, write, assign] |
ズーム操作を有効にする(デフォルト)か無効にするかを制御します。
有効にすると、ユーザーがピンチ操作でカメラをズームできます。
この場合、カメラによるプログラムによる移動は制限されません。
- (BOOL)navigationGestures [read, write, assign] |
ナビゲーション操作を有効にする(デフォルト)か無効にするかを制御します。
有効にした場合、ユーザーはナビゲーション リンクを 1 回タップするか、ビューをダブルタップして、パノラマ画像を変更できます。
これは、パノラマのプログラムによる制御を制限するものではありません。
- (BOOL)navigationLinksHidden [read, write, assign] |
タップ可能なナビゲーション リンクを表示するか、表示するかを制御します(デフォルト)。
非表示のナビゲーション リンクはタップできません。
-(BOOL)streetNamesHidden [read, write, assign] |
道路名のオーバーレイを非表示にするか、表示するかを制御します(デフォルト)。
- (GMSPanoramaCamera*) カメラ [read, write, assign] |
パノラマのカメラを制御します。
ここで新しいカメラを設定すると、新しいカメラの値にジャンプし、アニメーションは表示されません。
-(GMSPanoramaLayer*)レイヤ [read, retain] |
レイヤに使用されるカスタム CALayer タイプのアクセサー。