ストリートビュー

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。
プラットフォームを選択: Android iOS JavaScript

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 は、さまざまなストリートビュー画像にプログラムでアクセスできるようにする場合に最適です。
coordinate
この画像の正確な位置。CLLocationCoordinate2D で表現されます。パノラマの位置を永続的に保存する場合や、地図上のユーザー アクションをストリートビュー画像に変換する場合は、coordinate を使用します。

panoramaIDcoordinate はどちらも GMSPanorama オブジェクトのプロパティとして保存されます。coordinate または panoramaID を使用して、GMSPanoramaService から GMSPanorama をリクエストできます。結果として得られるオブジェクトには、メタデータと、付近のパノラマへのリンクの配列の両方が含まれます。

パノラマの位置を設定する

ストリートビュー パノラマの位置は、座標に基づいて設定できます。

  • moveNearCoordinate メソッドは、座標に近いパノラマをリクエストします。

  • moveNearCoordinate:radius メソッドも同様ですが、座標を中心とした検索範囲をメートル単位で指定できます。

  • moveNearCoordinate:source メソッドを使用すると、ソースを指定できます。source は、ストリートビューの検索を屋外のパノラマのみに制限する場合に役立ちます。デフォルトでは、場所のパノラマは内側か外側のどちらかになります。指定された場所の屋外のパノラマが存在しない場合があります。

  • moveNearCoordinate:radius:source メソッドを使用すると、半径と参照元の両方を指定できます。

ストリートビュー画像の表示

ストリートビュー ビューアの追加

ビューアを追加するための基本的なステップは次のとおりです。

  1. (1 回)スタートガイドの手順に沿って SDK を入手し、鍵を取得して必要なフレームワークを追加します。
  2. ViewController を作成または更新します。このビュー コントローラが表示されるときにパノラマを表示する場合は、必ず loadView メソッド内でパノラマを作成してください。
  3. GMSPanoramaView initWithFrame: メソッドを使用して、GMSPanoramaView クラスを作成し、インスタンス化します。これをビュー コントローラの唯一のビューとして使用する場合は、CGRectZero を地図のフレームとして使用できます。この場合、地図は自動的にサイズ変更されます。
  4. GMSPanoramaView オブジェクトをビュー コントローラのビューとして設定します(例: self.view = panoView;)。
  5. ストリートビュー画像の場所は、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 スキームをストリートビュー モードで起動するには、iOS 向け Google マップ アプリケーションを起動します。これを行うには、mapmode パラメータを streetview に設定します。ストリートビューを起動する 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 は、カメラ中心の回転角度を、真北からの相対角度で定義します。方向は、時計回りに測定します。true 北は 0、東は 90、南は 180、西は 270 です。
  • pitch(デフォルトは 0)は、カメラの初期デフォルト ピッチからの「上」または「下」向きの角度を定義します。通常は水平です(常に水平とは限りません。(たとえば、山で撮影された画像は、水平ではないデフォルトの初期ピッチで表示される場合があります)。ピッチ角度は、見上げる方向を正の値(デフォルトのピッチと直行する真上方向が +90 度)で、下を向く方向を負の値(デフォルトのピッチと直交する真下の方向が -90 度)として測定します。

Zoom

ストリートビューでは、ズームを使用してさまざまなレベルの画像の詳細をサポートします。 プログラムを使ってズームレベルを設定することも、ユーザーがピンチ操作によるズームでビューアのレベルを変更することもできます。

カメラの移動

GMSPanoramaView を作成し、設定済みのカメラまたはデフォルトのカメラがある場合は、次のいずれかの方法で変更できます。カメラを変更する場合、カメラの移動をアニメーション化するオプションがあります。アニメーションによって、現在のカメラ属性から新しいカメラ属性にスムーズに表示が切り替わります。

GMSPanoramaCamera オブジェクトを変更し、GMSPanoramaViewcamera プロパティに設定します。これにより、カメラは新しい視点にスナップなしでスナップされます。GMSCameraPosition を作成して、向きとズームの任意の組み合わせを構成できます。

Swift

panoView.camera = GMSPanoramaCamera(heading: 180, pitch: -10, zoom: 1)
      

Objective-C

panoView.camera = [GMSPanoramaCamera cameraWithHeading:180
                                                 pitch:-10
                                                  zoom:1];
      

GMSPanoramaViewanimateToCamera:animationDuration: メソッドを呼び出して、遷移をアニメーション化できます。さらに、Core Animation を使ってカメラをコントロールすることもできます。これは、GMSPanoramaViewGMSPanoramaLayer のカスタム 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 のメソッドのリストをご覧ください。