Street View Image リクエストは、次の形式の 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」に変換してください。Street View Static API は、その位置に最も近いパノラマ写真にスナップします。住所のテキスト文字列を指定すると、API は指定された場所を適切に表示するために、別のカメラの場所を使用することがあります。緯度と経度の座標を指定すると、API は半径 50 m でその場所に最も近い写真を検索します。ストリートビューの画像は定期的に更新され、毎回わずかに異なる位置から写真が撮影されることがあります。そのため、画像が更新されると、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
)は、パノラマを検索する半径(メートル単位)を設定します。指定された緯度と経度を中心とした半径になります。有効な値は 0 または正の整数です。return_error_code
は、画像が見つからないとき(404 NOT FOUND)、無効なリクエスト(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 によって「申し訳ございません。ここには画像がありません」というテキストを含むグレーの汎用画像が返されます。
有効な画像のみを表示
汎用的な画像が表示されないようにして、ウェブページに有効な Street View Static API の画像のみが表示されるようにするには、次の方法をおすすめします。
return_error_code
パラメータをtrue
に設定します。これにより、指定された場所の画像がない場合、Street View Static API から、一般的なグレーの画像の代わりに 404 NOT FOUND エラーが返されます。- リクエストを送信する前に、ストリートビュー画像メタデータをリクエストして、指定した場所で利用可能な画像があるかどうかを判断します。