ストリートビュー画像のリクエストは、次の形式の HTTP URL です。
https://maps.googleapis.com/maps/api/streetview?parameters
画像はリクエスト パラメータを使用して指定します。URL の標準規則と同様に、すべてのパラメータはアンパサンド（&）文字を使用して区切ります。使用可能なパラメータとその有効な値のリストを次に示します。
必須パラメータ
次のいずれかを実行します。
locationには、テキスト文字列（Chagrin Falls, OHなど）または緯度と経度の座標ペア（40.457375,-80.009353）を指定できます。URL エンコードする必要があります。そのため、リクエストを送信する前に、「City Hall, New York, NY」などの住所を「City+Hall,New+York,NY」に変換します。ストリートビュー Static API は、指定された場所に最も近いパノラマ写真にスナップします。住所のテキスト文字列を指定すると、API は、指定された場所をより適切に表示するために、別のカメラ位置を使用することがあります。緯度と経度の座標を指定すると、API はその場所に最も近い写真を半径 50 メートルの範囲で検索します。ストリートビューの画像は定期的に更新され、撮影位置も毎回わずかに異なる可能性があるため、画像が更新されるとlocationが別のパノラマにスナップされる可能性があります。
または
panoは、特定のパノラマ ID です。パノラマの ID は時間の経過とともに変更される可能性があるため、この ID を保持しないでください。代わりに、パノラマ ID を更新できるように、位置の住所または緯度と経度の座標を保存します。詳細については、削除されたパノラマ ID を更新するをご覧ください。
さらに:
sizeは、画像の出力サイズをピクセル単位で指定します。サイズは{width}x{height}として指定します。たとえば、size=600x400を指定すると、幅 600 ピクセル、高さ 400 ピクセルの画像が返されます。keyを使用すると、Google Cloud コンソールでアプリケーションの API 使用状況をモニタリングできます。また、必要に応じて Google がアプリケーションについて連絡できるようになります。詳細については、キーと署名を取得するをご覧ください。
削除されたパノラマ ID を更新する
パノラマ ID を取得しようとして ZERO_RESULTS または値が返されない場合、パノラマ ID は削除されているため、更新する必要があります。
パノラマ ID の取得に使用した場所の住所または緯度と経度の座標を保存して、必要に応じて更新できるようにします。
パノラマ ID が変更されたことを検出したら、元の場所の住所または緯度と経度の座標を使用して、その場所に最も近いパノラマを再度検索し、新しいパノラマ ID を取得します。
オプション パラメータ
signature（推奨）は、API キーを使用して生成リクエストを生成するサイトが、許可されたサイトであることを確認するために使用されるデジタル署名です。デジタル署名が含まれていないリクエストは失敗する可能性があります。詳細については、キーと署名を取得するをご覧ください。注: 以前の Google Maps Platform プレミアム プランのお客様は、デジタル署名が必要です。詳しくは、プレミアム プランのお客様向けの認証パラメータをご覧ください。
headingは、カメラのコンパス方位を示します。指定できる値は0～360です（どちらの値も北を示し、90は東、180は南を示します）。方位を指定しない場合、最も近い写真が撮影された地点から、指定されたlocationにカメラを向ける値が計算されます。fov（デフォルトは90）は、画像の水平方向の画角を度単位で指定します。最大許容値は120です。ストリートビューの画像のように固定サイズのビューポートを扱う場合、画角は実質的にズームを表し、数値が小さいほどズームレベルが高くなります。
（左:fov=120、右:fov=20）pitch（デフォルトは0）は、ストリートビュー撮影車に対するカメラの上下の角度を指定します。多くの場合、初期デフォルト ピッチは水平方向ですが、必ずそうであるとは限りません。正の値はカメラを上向きに傾け（90度で真上を向く）、負の値はカメラを下向きに傾けます（-90で真下を向く）。radius（デフォルトは50）は、パノラマを検索する半径（メートル単位）を設定します。指定された緯度と経度の地点を中心とした半径になります。有効な値は非負整数です。return_error_codeは、画像が見つからない場合（404 見つかりません）または無効なリクエストに対するレスポンス（400 BAD REQUEST）で、API がエラーコードを返すかどうかを示します。有効な値はtrueとfalseです。trueに設定すると、一般的なグレーの画像の代わりにエラー メッセージが返されます。これにより、画像の可用性を確認するために別の呼び出しを行う必要がなくなります。source（デフォルトはdefault）: ストリートビューの検索を、選択したソースに限定します。指定できる値は次のとおりです。defaultは、ストリートビューのデフォルトのソースを使用します。検索対象が特定のソースに限定されません。outdoorは、検索対象を屋外のパノラマのみに限定します。屋内コレクションは検索結果に含まれません。なお、指定された場所の屋外のパノラマが存在しない場合があります。また、検索では、屋内か屋外かを判断できるパノラマのみが返されます。たとえば、PhotoSphere は屋内か屋外かが不明なため、返されません。
これはリクエストの例です。
https://maps.googleapis.com/maps/api/streetview?size=600x300&location=46.414382,10.013988&heading=151.78&pitch=-0.76&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
使用できる画像がない場合
ストリートビューの画像が利用できない場所の場合、Street View Static API は、次の例に示すように、「申し訳ありません。この場所の画像はありません。」というテキストを含む灰色の汎用画像を返します。
有効な画像のみを表示する
汎用画像が表示されないようにし、ウェブページに有効なストリートビュー Static API 画像のみが表示されるようにするには、次の方法をおすすめします。
return_error_codeパラメータをtrueに設定します。これにより、指定した場所の画像がない場合、Street View Static API は一般的なグレーの画像の代わりに 404 NOT FOUND エラーを返します。- リクエストを送信する前に、ストリートビュー画像のメタデータをリクエストして、指定した場所の画像が利用可能かどうかを判断します。