Google ストリートビューをURLパラメータで表示する

【概要】

Google マップ／ストリートビューのURLにパラメータを指定すると、特定の場所を特定の向き・ズームで表示するリンクを作成できる。Webサイトへのリンク掲載や場所の共有に利用できる。本記事では、ブラウザだけで完結する方法として、緯度経度の指定（cbll）と、表示を制御する5つの値（cbp）を解説する。プログラミングやソフトのインストールは不要で、Windows・Mac等のOSを問わずブラウザがあれば利用できる。

【その他情報】

本記事で扱う cbll／cbp 形式のURLは、Googleが公式にドキュメント化していない非公式な仕様である。一部のパラメータ（特にcbpの3番目と5番目）は、解説によって定義が一致していない。本記事では、表示への効果が大きく挙動が安定している2番目（回転角）・4番目（ズーム）・5番目（ピッチ）を中心に扱い、定義が一致しない値については「通常は0でよい」という指針を示す。

自分の見たい場所のURLを作るには緯度経度が必要になる。Googleマップ上で目的地を右クリックすると緯度経度（緯度,経度の順）が表示されるので、これをコピーしてcbllに指定する。安定運用や商用利用を想定する場合は、本記事末尾で触れる公式API（Maps Embed API 等）の利用を推奨する。

【目次】

【関連する外部ページ】

安定して利用したい場合は、Google が提供する「Maps Embed API」や「Maps URLs」などのドキュメント化されたインターフェースの利用を検討する（詳細は本文末尾「利用上の注意事項」を参照）。

URLでストリートビューを開く基本構造

ブラウザで次のURLを開く。インストール作業は不要で、ブラウザがあればOSを問わず動作する。

https://maps.google.com/maps?q=&layer=c&cbll=34.4888,133.3613&cbp=11,0,0,0,0

ストリートビューの表示例（上半分がストリートビュー、下半分が地図）

URLの構成要素は次の通りである。cbll と cbp が必須で、q は空でよい。

cbpパラメータ：5つの値で表示を制御する

cbpパラメータは5つの値をカンマ区切りで指定する。「cbp=11,0,0,0,0」の各値の意味は次の通りである。表示への効果が大きいのは、2番目（回転角）・4番目（ズーム）・5番目（ピッチ）である。

  1. 表示配置（arrangement）: 11=上半分がストリートビュー・下半分が地図、12=ストリートビューが大部分で隅に小さな地図。

    前節の図は配置「11」（上半分ストリートビュー・下半分地図）の例である。「12」を指定すると、地図が隅の小さな表示になる。

  2. 回転角（bearing）: 水平方向の向きを度数で指定する。0=北、90=東、-90（または270）=西、180=南。

    回転角90度（東向き）:

    https://maps.google.com/maps?q=&layer=c&cbll=34.4888,133.3613&cbp=11,90,0,0,0

    回転角90度（東向き）の表示例

    回転角45度（北東向き）:

    https://maps.google.com/maps?q=&layer=c&cbll=34.4888,133.3613&cbp=11,45,0,0,0

    回転角45度（北東向き）の表示例

    回転角0度（北向き）:

    https://maps.google.com/maps?q=&layer=c&cbll=34.4888,133.3613&cbp=11,0,0,0,0

    回転角0度（北向き）の表示例

    回転角-45度（北西向き）:

    https://maps.google.com/maps?q=&layer=c&cbll=34.4888,133.3613&cbp=11,-45,0,0,0

    回転角-45度（北西向き）の表示例

    回転角-90度（西向き）:

    https://maps.google.com/maps?q=&layer=c&cbll=34.4888,133.3613&cbp=11,-90,0,0,0

    回転角-90度（西向き）の表示例
  3. ティルト角（tilt）: -90から90の範囲で指定する。非公式仕様のため解説によって定義が一致しておらず、通常は0でよい。カメラの上下の向きは5番目（ピッチ角）で調整する。
  4. ズームレベル（zoom）: 拡大率を0から2の範囲で指定する。0=広範囲表示、2=最大拡大。

    ズームレベル2（最大拡大）:

    https://maps.google.com/maps?q=&layer=c&cbll=34.4888,133.3613&cbp=11,0,0,2,0

  5. ピッチ角（pitch）: カメラの上下の向きを度数で指定する。-90=真上方向、0=水平方向、90=真下方向（既定値は5）。

    ピッチ角-45度（やや上向き）:

    https://maps.google.com/maps?q=&layer=c&cbll=34.4888,133.3613&cbp=11,0,0,0,-45

利用上の注意事項