Google マップのストリートビューでは、世界中のあらゆる場所を道路単位の 360 度画像で見ることができます。世界のランドマークを探索したり、自然の驚異を眺めたり、旅行を案内したり、ビジネスの外観を見せたりできます。
概要
Google ストリートビューは、対象地域全体について、指定された道路からの 360 度のパノラマビューを提供します。SDK の対象地域は、iOS 向け Google マップ アプリや https://maps.google.com/ と同じです。ストリートビューの詳細や、インタラクティブ マップでサポートされる地域については、ストリートビューについてをご覧ください。
Maps SDK for iOS には、Google マップのストリートビューで使用される画像を取得、操作するためのストリートビュー サービスが用意されています。ストリートビューの画像はパノラマとして返され、ストリートビュー ビューア（GMSPanoramaView タイプのオブジェクト）内から表示されます。
ストリートビュー パノラマ
各ストリートビュー パノラマは、単一地点からの 360 度ビューを提供する 1 枚の画像または画像のセットです。画像は正距円筒図法（Plate Carrée 図法）に準拠し、360 度の水平ビュー（周囲全体）と 180 度の垂直ビュー（真上から真下）が含まれます。生成される 360 度パノラマ画像は、球体の 2 次元表面を包む画像によって、その球体への投影を定義します。
ストリートビュー パノラマは、GMSPanoramaView オブジェクトで表示できます。このオブジェクトは、パノラマ画像を球体としてレンダリングするビューアを提供し、その中央にカメラがあります。カメラの向きや、ビューアをカスタマイズするいくつかのプロパティをプログラムで制御できます。
ストリートビューのデータへのアクセス
ストリートビューのパノラマ画像は、2 つのメタデータのどちらかで特定することができます。
panoramaID- ストリートビュー パノラマの一意の ID。この
panoramaIDは今後変更される可能性があるため、長期的な参照やハードコードされた参照には適していません。panoramaIDは、さまざまなストリートビュー画像にプログラムでアクセスできるようにする場合に最適です。 coordinateCLLocationCoordinate2Dで表される、この画像の正確な位置。coordinateを使用して、パノラマの位置を永続的に保存したり、地図上でのユーザー操作をストリートビューの画像に変換したりできます。
panoramaID と coordinate はどちらも GMSPanorama オブジェクトのプロパティとして保存されます。coordinate または panoramaID を使用して、GMSPanoramaService から GMSPanorama をリクエストできます。結果として得られるオブジェクトには、メタデータと、付近のパノラマ画像へのリンクの配列が含まれます。
パノラマの位置を設定する
ストリートビュー パノラマの位置は、座標に基づいて設定できます。
moveNearCoordinateメソッドは、この座標に近いパノラマをリクエストします。moveNearCoordinate:radiusメソッドもこれと似ていますが、座標を中心とした検索半径をメートル単位で指定できます。moveNearCoordinate:sourceメソッドを使用すると、ソースを指定できます。source は、ストリートビューの検索を屋外のパノラマのみに制限する場合に役立ちます。デフォルトでは、場所のパノラマは屋内または屋外にあります。なお、指定された場所の屋外のパノラマが存在しない場合があります。moveNearCoordinate:radius:sourceメソッドでは、半径とソースの両方を指定できます。
ストリートビュー画像の表示
ストリートビュー ビューアを追加する
ビューアを追加するための基本的なステップは次のとおりです。
- （1 回限り）スタートガイドの手順に沿って SDK を入手し、キーを取得して、必要なフレームワークを追加します。
ViewControllerを作成または更新します。このビュー コントローラが表示されるときにパノラマを表示する場合は、必ずloadViewメソッド内で作成してください。GMSPanoramaViewinitWithFrame:メソッドを使用して、GMSPanoramaViewクラスを作成してインスタンス化します。これをビュー コントローラの唯一のビューとして使用する場合は、CGRectZeroを地図のフレームとして使用できます。地図は自動的にサイズ変更されます。GMSPanoramaViewオブジェクトをビュー コントローラのビューとして設定します（例:self.view = panoView;）。moveNearCoordinate:などのメソッドを使用して、ストリートビュー画像の位置を設定します。
次の例では、アプリにストリートビュー ビューアを追加しています。
Swift
import GoogleMaps
class StreetView: UIViewController {
override func loadView() {
let panoView = GMSPanoramaView(frame: .zero)
self.view = panoView
panoView.moveNearCoordinate(CLLocationCoordinate2D(latitude: -33.732, longitude: 150.312))
}
}
Objective-C
#import "StreetView.h"
@import GoogleMaps;
@interface StreetView ()
@end
@implementation StreetView
- (void)loadView {
GMSPanoramaView *panoView = [[GMSPanoramaView alloc] initWithFrame:CGRectZero];
self.view = panoView;
[panoView moveNearCoordinate:CLLocationCoordinate2DMake(-33.732, 150.312)];
}
@end
ビューアをカスタマイズする
利用できる操作を制限して、ビューアをカスタマイズできます。デフォルトでは、パン、ズーム、隣接するパノラマへの移動はすべて有効になっています。個々の操作は GMSPanoramaView のプロパティで制御されます。これらのプロパティでは、ユーザー制御の操作を有効または無効にできます。操作が無効になっていても、プログラムによる変更は可能です。
orientationGestures- ユーザーがタップまたはドラッグでカメラの向きを変更できるかどうか。カメラの向きの変更を無効にするには、
NOに設定します。 zoomGestures- ユーザーがピンチしてズームできるかどうかを指定します。ズームを無効にするには、
NOに設定します。 navigationGestures- 表示するパノラマをユーザーが変更できるかどうか。ユーザーは、ナビゲーション リンクを 1 回タップするか、ビューをダブルタップしてパノラマを変更できます。
NOに設定すると、ナビゲーションの変更が無効になります。
setAllGesturesEnabled: メソッドを使用すると、すべての操作を一度に有効または無効にできます。
Swift
panoView.setAllGesturesEnabled(false)
Objective-C
[panoView setAllGesturesEnabled:NO];
URL スキームを使用したストリートビューの起動
Google ストリートビュー画像は、iOS 向け Google マップ アプリ内で表示できます。comgooglemaps URL スキームで mapmode パラメータを streetview に設定すると、iOS 向け Google マップ アプリをストリートビュー モードで起動できます。ストリートビューを起動する URL の例を以下に示します。詳しくは、URL スキームのドキュメントをご覧ください。
comgooglemaps://?center=46.414382,10.013988&mapmode=streetview
ストリートビューの場所と視点（POV）
GMSPanoramaCamera を使用すると、ストリートビュー カメラの視点を角度、ピッチ、ズームの組み合わせとして設定できます。
次のスニペットは、カメラの方向を南向きにし、わずかに下を向けています。
Swift
panoView.camera = GMSPanoramaCamera(heading: 180, pitch: -10, zoom: 1)
Objective-C
panoView.camera = [GMSPanoramaCamera cameraWithHeading:180
pitch:-10
zoom:1];
オリエンテーション
ストリートビューの位置は、画像に対するカメラのフォーカスの位置を定義しますが、その画像に対するカメラの向きは定義しません。その目的のために、GMSOrientation オブジェクトは次の 2 つのプロパティを定義します。
headingは、カメラ中心の回転角度を、真北からの相対角度で定義します。方角は時計回りで測定されます。真北が 0、東が 90、南が 180、西が 270 です。pitch（デフォルトは0）は、カメラの初期デフォルト ピッチからの「上」または「下」の角度を定義します。通常は水平方向ですが、常にそうとは限りません。（たとえば、山で撮影された画像は、水平ではないデフォルトのピッチで表示される可能性があります）。ピッチ角度は、上向きの正の値（デフォルトのピッチと直交する真上方向 +90 度）と下向きの負の値（デフォルトのピッチと直交する真下方向の -90 度）で測定します。
ズーム
ストリートビューでは、ズームを使用してさまざまなレベルの画像の詳細を確認できます。ズームレベルはプログラムで設定できます。また、ユーザーがビューアでピンチ操作してズームすることでレベルを変更することもできます。
カメラの移動
GMSPanoramaView を作成し、構成済みのカメラまたはデフォルトのカメラを指定したら、複数の方法で変更できます。カメラを変更するときに、カメラの移動にアニメーションを付けることもできます。アニメーションによって、現在のカメラ属性から新しいカメラ属性にスムーズに表示が切り替わります。
GMSPanoramaCamera オブジェクトを変更して、GMSPanoramaView の camera プロパティで設定できます。これにより、カメラはアニメーションなしで新しい視点にスナップされます。GMSCameraPosition を作成して、向きとズームの任意の組み合わせを構成できます。
Swift
panoView.camera = GMSPanoramaCamera(heading: 180, pitch: -10, zoom: 1)
Objective-C
panoView.camera = [GMSPanoramaCamera cameraWithHeading:180
pitch:-10
zoom:1];
GMSPanoramaView の animateToCamera:animationDuration: メソッドを呼び出して、遷移をアニメーション化できます。さらに、Core Animation を使ってカメラをコントロールすることもできます。これは、GMSPanoramaLayer の GMSPanoramaView にカスタム CALayer を介して使用できます。
ストリートビュー内のマーカー
GMSPanoramaView オブジェクトでは、地図上のマーカーを表示できます。対応するプロパティを設定すると、GMSMapView オブジェクトまたは GMSPanoramaView オブジェクトで同じ GMSMarker オブジェクトを使用できます。
Swift
// Create a marker at the Eiffel Tower
let position = CLLocationCoordinate2D(latitude: 48.858, longitude: 2.294)
let marker = GMSMarker(position: position)
// Add the marker to a GMSPanoramaView object named panoView
marker.panoramaView = panoView
// Add the marker to a GMSMapView object named mapView
marker.map = mapView
Objective-C
// Create a marker at the Eiffel Tower
CLLocationCoordinate2D position = CLLocationCoordinate2DMake(48.858,2.294);
GMSMarker *marker = [GMSMarker markerWithPosition:position];
// Add the marker to a GMSPanoramaView object named panoView
marker.panoramaView = panoView;
// Add the marker to a GMSMapView object named mapView
marker.map = mapView;
マーカーのサイズは、マーカーの位置と GMSCameraView の位置との距離に応じて拡大されます。この距離が長すぎると、マーカーは小さすぎて表示できなくなり、ビューに表示されなくなります。
panoramaView プロパティを nil に設定して GMSPanoramaView から削除します。
Swift
marker.panoramaView = nil
Objective-C
marker.panoramaView = nil;
イベント
ストリートビュー パノラマで発生するイベント（ユーザーがパノラマをタップしたときなど）をリッスンできます。イベントをリッスンするには、GMSPanoramaViewDelegate プロトコルを実装する必要があります。イベントに関するガイド全体と、GMSPanoramaViewDelegate のメソッドのリストをご覧ください。