Google Maps Platform に間もなく新しい地図のスタイルが導入されます。このアップデートにより、デフォルトのカラーパレットが新しくなるほか、地図のエクスペリエンスとユーザビリティが改善されます。すべての地図のスタイルは、2025 年 3 月に自動的に更新されます。ご利用の詳細およびいち早く使用する方法については、Google Maps Platform の新しい地図のスタイルをご覧ください。

このページは Cloud Translation API によって翻訳されました。

ストリートビュータイル

ストリートビューの例 Street View Tiles とは 2D タイルただし、道路レベルで撮影されたパノラマ画像が含まれています。ありストリートビューでは、世界中のランドマークを探索したり、自然の絶景を眺めたり、美術館、アリーナ、レストラン、小規模ビジネスなどの施設内に表示されます。この API エンドポイントを使用すると、以下にアクセスできます。

Google マップストリートビュータイル
ストリートビューのメタデータ
ストリートビューのサムネイル

ストリートレベルで撮影された画像タイルをつなぎ合わせて、実際のパノラマ効果を使用します。1 つのセットに対して最大 100 個のパノラマ ID をクエリできます。撮影場所（ルートなど）を取得し、カメラに関する詳細なメタデータを取得なります。

ストリートビューのタイルを合成するにはビューアが必要です。たとえば、ストリートビューカスタムパノラマビューア

API キーを取得したら、次の手順でストリートビュー画像にアクセスできます。行います。

セッショントークンを取得します。必ず mapType の値を streetview に設定します。
セッショントークンを使用して 1 つ以上の地理位置情報のパノラマ ID（pannoId）を取得提供します
pannoId 検索レスポンスのパノラマ ID を使用して、以下を取得します。
1. ストリートビューのメタデータ。ストリートビュー座標と半径のセットを渡してメタデータを表示します。
2. ストリートビューのサムネイル。
3. ストリートビュータイル。

で確認できます。

ストリートビューのメソッド

ストリートビューの画像とメタデータにアクセスするには、次のいずれかを呼び出します。 4 つのメソッドがあります

メソッド	説明
`https://tile.googleapis.com/v1/streetview/tiles`	個々のストリートビュータイルを返します。Street View Tiles は、512 ピクセルから最大 13,312 ピクセルまでの 6 つのズームレベルで取得できます。
`https://tile.googleapis.com/v1/streetview/panoIds`	最大 100 か所のビジネス情報を一括検索できます。画像があるすべての場所のパノラマ ID を返します。
`https://tile.googleapis.com/v1/streetview/thumbnail`	ストリートビューシーンのサムネイル JPEG 画像を返します。方角、ピッチ、寸法、画角を指定できます。最小サイズは 16×16 ピクセルです。最大サイズは 250×600 ピクセルです。
`https://tile.googleapis.com/v1/streetview/metadata`	指定したパノラマに関する詳細情報を提供します。詳細には、関連する住所や隣接するパノラマへのリンクが含まれます。

ストリートビューの ParquetIds の検索

1 つ以上の地理的位置のパノラマ識別子は、座標（lat、lng）を panoIds メソッドに渡します。リクエスト body は locations 配列を含む JSON オブジェクトで、必要に応じて radius に設定することをおすすめします。

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?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY"

locations: locations 配列には座標値のセットを 1 つ以上含める必要があります。ただし、 100 個まで追加できます。
radius: radius 値（メートル単位）は円の半径を定義しますパノラマを検索します。デフォルト値 50 m です。

PanoId レスポンス

Map Tiles API は、各場所に最も近いパノラマを探し、パノラマ ID が返されます。panoIds リクエストに成功すると、 panoIds 配列を含む JSON オブジェクト。配列には、指定した名前のリストがリクエストした順序のパノラマ ID になります。Map Tiles API の場合リクエストされた場所のパノラマが見つからなかった場合、配列のその位置に返されます。例については、次の JSON コードで記述します。

{
  "panoIds": [
    "ACfH-n2HcBvRry_3oc9grw",
    "f5DJZatBAAAXHlooS2wKbw",
    ""
  ]
}

panoIds を使用すると、次のことができます。

ストリートビューのメタデータをリクエストする
ストリートビューのサムネイルをリクエストする
Street View Tiles をリクエストする

で確認できます。

ストリートビューのメタデータ

ストリートビューメタデータリクエストは、パノラマに関する情報を取得します。通りメタデータの表示リクエストは HTTPS GET リクエストです。Google Cloud コンソールで次の 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"

ストリートビュー画像の ParquetId を渡す

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 を、 1 回のユーザーセッションよりも長い期間有効です。
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: 構造化されたジオコードにパノラマの住所の詳細が格納されています。詳しくはジオコーディングのリクエストとレスポンスをご覧ください。
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 レスポンスで指定したもの）を返します。

Tile リクエストが成功した結果

ズームレベル 0 では、パノラマ全体が寸法のタイルにサイズ変更されます。 tileHeight による tileWidth。パノラマは x 次元の方が大きいため、タイルの y 次元に空白スペースが含まれます。

ズームレベル 0

ズームレベル 5 では、フルサイズのパノラマ画像が使用され、タイルに分割されます。

著作権情報

すべてのストリートビューパノラマに著作権情報を表示する必要があります。「表示する文字列はパノラマによって異なります。著作権情報を取得するには、ストリートビューメタデータをリクエストすると、レスポンスの copyright フィールドを参照してください。詳細については、次をご覧ください: データの帰属表示。