Street View Tiles は、道路レベルで撮影されたパノラマ画像が含まれているという点以外は 2D タイルと同様です。ストリートビューでは、世界の名所を巡り、絶景を楽しむことができます。博物館や競技場、レストラン、お店などの施設の中の様子も見ることができます。この API エンドポイントを使用すると、次のものにアクセスできます。
- Google マップ ストリートビュー タイル
- ストリートビューのメタデータ
- ストリートビューのサムネイル
街路単位で撮影された画像タイルを合成して、実際のパノラマ スタイルの効果を作り出せます。また、一連の場所（ルートなど）に対して最大 100 個のパノラマ ID を照会し、カメラの位置に関するより詳細なメタデータを取得できます。
ストリートビュー タイルを合成するには、ビューアが必要です。たとえば、ストリートビューのカスタム パノラマ ビューアなどです。
API キーを取得したら、次の手順でストリートビュー画像にアクセスできます。
セッション トークンを取得します。
mapTypeの値はstreetviewに設定してください。セッション トークンを使用して、1 つ以上の地理的位置のパノラマ ID（panoId）を取得します。
panoId 検索レスポンスのパノラマ ID を使用して、次のことを取得します。
ストリートビューのメタデータ。座標と半径のセットを渡すことで、ストリートビューのメタデータを取得することもできます。
ストリートビューの方法
ストリートビューの画像とメタデータにアクセスするには、次の 4 つのメソッドのいずれかを呼び出します。
| メソッド | 説明 |
|---|---|
https://tile.googleapis.com/v1/streetview/tiles |
個々のストリートビュー タイルを返します。ストリートビュー タイルは、512 ピクセルから 13,312 ピクセルの 6 段階のズームレベルで取得できます。 |
https://tile.googleapis.com/v1/streetview/panoIds |
最大 100 件の場所を一括で検索できます。画像が存在するすべての場所のパノラマ ID を返します。 |
https://tile.googleapis.com/v1/streetview/thumbnail |
ストリートビュー シーンのサムネイル JPEG 画像を返します。向き、ピッチ、寸法、視野を指定できます。最小サイズは 16×16 ピクセルです。最大サイズは 250x600 ピクセルです。 |
https://tile.googleapis.com/v1/streetview/metadata |
指定したパノラマに関する詳細情報を提供します。詳細には、関連する住所、隣接するパノラマ画像へのリンクが含まれます。 |
ストリートビュー panoId 検索
1 つ以上の地理的位置のパノラマ ID を確認するには、座標（lat、lng）を panoIds メソッドに渡します。リクエスト本文は、次の JSON コード例に示すように、locations 配列と、必要に応じて radius を含む JSON オブジェクトです。
curl -X POST -d '{
"locations": [
{"lat": -33.883837, "lng": 151.209307},
{"lat": -33.883700, "lng": 151.210307},
{"lat": 0, "lng": 0}
],
"radius": 50
}' \
-H 'Content-Type: application/json' \
"https://tile.googleapis.com/v1/streetview/panoIds
locationslocations配列には、座標値のセットを 1 つ以上含める必要があります。最大 100 個まで含めることができます。radiusradius値（メートル単位）は、指定された場所を中心とした円の半径を定義します。この円の範囲内でパノラマを検索します。デフォルト値は 50 メートルです。
PanoId レスポンス
Map Tiles API は、各場所に最も近いパノラマを検索し、そのパノラマ ID を返します。panoIds リクエストが成功すると、panoIds 配列を含む JSON オブジェクトが返されます。この配列には、リクエストされた順序のパノラマ ID のリストが含まれます。Map Tiles API がリクエストされた場所のパノラマを見つけられない場合、配列の該当する場所では空白文字列が返されます。例については、次の JSON コードをご覧ください。
{
"panoIds": [
"ACfH-n2HcBvRry_3oc9grw",
"f5DJZatBAAAXHlooS2wKbw",
""
]
}
panoIds を使用すると、次のことができます。
ストリートビューのメタデータ
ストリートビュー メタデータ リクエストは、パノラマに関する情報を取得します。ストリートビュー メタデータ リクエストは HTTPS GET リクエストです。パノラマに関する情報を取得するには、次の 2 つの方法があります。
pano_idを渡すと、Map Tiles API からそのパノラマのメタデータが返されます。ただし、
latとlngを渡すと、Map Tiles API は指定された検索半径内の最も近いパノラマのメタデータを返します。
座標のセットと半径を渡す
curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY &lat=lat &lng=lng &radius=meters"
パノラマ ID は一時的なため、最初のストリートビュー メタデータ リクエストで座標のセットと radius 値を渡すことをおすすめします。例については、次のコード スニペットをご覧ください。
curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &lat=47.62066 &lng=-122.34923 &radius=50"
ストリートビュー画像の panoId を渡す
curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &panoId=panoId"
メタデータ レスポンス
次の JSON コードは、一般的なメタデータ レスポンスの例です。
{
"panoId": "rZ9KeTyhA11i0VppYNzsSg",
"lat": 37.420864219339165,
"lng": -122.08446528377291,
"imageHeight": 6656,
"imageWidth": 13312,
"tileHeight": 512,
"tileWidth": 512,
"heading": 94.35,
"tilt": 88.39652,
"roll": 1.7181772,
"imageryType": "outdoor",
"date": "2023-01",
"copyright": "© 2023 Google",
"reportProblemLink": "https://cbks0.googleapis.com/cbk?output=report&panoid=rZ9KeTyhA11i0VppYNzsSg&cb_client=api&cbp=1,0,,0,0&hl=en-US&gl=us",
"addressComponents": [
{
"longName": "United States",
"shortName": "United States",
"types": [
"country"
]
},
{
"longName": "Mountain View, California",
"shortName": "Mountain View, California",
"types": [
"locality"
]
},
{
"longName": "Charleston Rd",
"shortName": "Charleston Rd",
"types": [
"route"
]
},
{
"longName": "1635",
"shortName": "1635",
"types": [
"street_number"
]
}
],
"links": [
{
"panoId": "Yw4pqzA4FEq1qs-BwZSvSQ",
"heading": 274.47998046875,
"text": "Charleston Rd"
},
{
"panoId": "1cODYwFRw1aZ45IignDIMw",
"heading": 94.47999572753906,
"text": "Charleston Rd"
}
]
}
次のリストに、レスポンスの本文のフィールドの定義を示します。
panoId- このパノラマの一意の ID。パノラマ ID が単一のユーザー セッションよりも長い時間有効であることを前提としないでください。
lat、lng- パノラマの座標（緯度と経度）。これらの値は、場所が最も近いパノラマにスナップされるため、リクエストで渡した座標とは異なる場合があります。
imageHeight、imageWidth- ステッチされたパノラマ画像のサイズ。
tileHeight、tileWidth- 単一のパノラマタイルの寸法。
heading- 北からの時計回りの度数で表されるコンパスの向首方向。向首方向は [0, 360] の範囲で返されます。0 は北を示します。
tilt- パノラマの傾斜。パノラマの南極から水平までの角度で表されます。返される値の範囲は [0, 180] です。値 90 度は、パノラマ画像の赤道が水平位置にあります。
roll- 水平線を水平にするためにパノラマに適用される、視線を軸とした時計回りの回転。返される値の範囲は [0, 360] です。
imageryType- は画像のタイプを示します。有効な値は
indoorとoutdoorです。 date- 画像が撮影された日付。日付データが存在しない画像もあります。日付データが利用可能な場合、このフィールドには年（YYYY）と月（MM）を組み合わせたものが含まれます。例: 2023-05、2024 など。
copyright- ストリートビュー画像とともに表示する必要がある著作権の帰属に関するテキスト。
reportProblemLink- このストリートビュー タイルに関する問題を報告するためにユーザーが使用できるハイパーリンク。このハイパーリンクは画像の右下に表示し、リンクテキストには「この画像に関する問題を報告」などのように記載する必要があります。
addressComponent- パノラマの住所に関する詳細を含む構造化されたジオコード。詳細については、Geocoding API ドキュメントのジオコーディング リクエストとレスポンスをご覧ください。
links- このパノラマにリンクするパノラマ ID のリスト。また、リンクが見つかった見出しも含まれます。たとえば、向首方向が 180° の場合、リンクしたパノラマ画像は現在のパノラマ画像の真南にあります。パノラマ ID は一時的なものであるため、単一のユーザー セッション以外でこれらの情報を利用することはできません。
ストリートビューのサムネイル
ストリートビュー画像は thumbnail 形式でリクエストできます。サムネイルは、ユーザー定義のサイズ、向首方向、ピッチ、視野が指定された、タイル化されていない画像です。サムネイル画像はタイルより解像度が低く、ファイルサイズが小さくなっています。サムネイル リクエストは、次のコード プロトタイプに示すように、thumbnail エンドポイントに GET リクエストを送信することで行います。
curl "https://tile.googleapis.com/v1/streetview/thumbnail?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &panoId=panoId &height=FROM_16_TO_250 &width=FROM_16_TO_600 &pitch=FROM-90_TO_90 &yaw=FROM-360_TO_360 &fov=FROM_30_TO_120"
次のコード例では、カナダのウィスラーで撮影されたストリートビュー画像のサムネイルをダウンロードします。
curl "https://tile.googleapis.com/v1/streetview/thumbnail?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &panoId=Zzl28rqGJgaL2IdkUleP8A &height=200 &width=200 &pitch=0 &yaw=250 &fov=80" --output /tmp/example_thumbnail.png
必須パラメータ
panoId- 目的のサムネイルの一意の ID。パノラマ ID 値は、
panoIdsエンドポイントまたはmetadataエンドポイントから取得できます。どちらのエンドポイントも地理的座標を受け取り、適切なpanoIdを返します。 session- 有効なセッション トークン。
key- 有効な API キー。
オプション パラメータ
height- サムネイルの高さをピクセル単位で指定します（16 ピクセル～ 250 ピクセルの範囲）。高さを指定しない場合、高さはデフォルトで許容最大値の 250 ピクセルになります。範囲外の値を指定すると、サムネイルは最も近い有効な値にスナップされます。
width- サムネイルの幅をピクセル単位で指定します（16 ピクセル～ 600 ピクセルの範囲）。幅を指定しない場合、幅はデフォルトで許容最大値の 600 ピクセルに設定されます。範囲外の値を指定すると、サムネイルは最も近い有効な値にスナップされます。
pitch- カメラの垂直軸の角度を指定します。有効な値は
-90～90です。デフォルト値は 0 です。 yaw- カメラの水平方向の角度を指定します。有効な値は
-360～360の範囲です。デフォルト値は 0 です。 fov- 水平方向の視野角を指定します。度数で表され、最大値は 120 です。ストリート ビューの画像サイズの設定と同様に、固定サイズのビューポートを処理する場合、視野はズームに相当します。値が小さいほどズームレベルは高くなります。デフォルト値は 90 です。
ストリートビュー画像タイル
panoId を取得したら、ストリートビュー画像タイルをリクエストできます。タイル リクエストは HTTPS GET リクエストです。次に例を示します。
curl "https://tile.googleapis.com/v1/streetview/tiles/z/x/y?session=YOUR_SESSION_TOKEN &key=YOUR_API_KEY &panoId=panoId"
このコード例では、z はズームレベル、x と y は目的のストリートビュー タイルのタイル座標です。ストリートビュー パノラマ画像のズームレベルは、[0, 5] の範囲である必要があります。0 は最も広い視野を表します。
| ズーム レベル | 画角（おおよその値） |
|---|---|
| 0 | 360° |
| 1 | 180° |
| 2 | 90° |
| 3 | 45° |
| 4 | 22.5° |
| 5 | 11.25° |
Street View Tiles のレスポンス
ストリートビュー タイル リクエストが成功すると、createSession レスポンスで指定した形式とサイズの画像が返されます。
ズームレベル 0 では、パノラマ全体のサイズが tileWidth x tileHeight のタイルに変更されます。パノラマ画像は x 方向に長いため、タイルの y 方向には空白スペースが含まれます。
ズームレベル 5 ではフルサイズのパノラマ画像が使用され、タイルに分割されます。
著作権情報
すべてのストリートビュー パノラマ画像には、著作権情報を表示する必要があります。表示する文字列はパノラマによって異なります。著作権情報を取得するには、ストリートビュー メタデータをリクエストし、レスポンスの copyright フィールドを参照する必要があります。詳細については、データのアトリビューションをご覧ください。