ストリートビューのリクエストとレスポンス

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 メートルの範囲を検索し、その場所に最も近い写真を探します。ストリートビューの画像は定期的に更新され、毎回わずかに異なる地点から写真が撮影されることがあります。そのため、画像がアップデートされると、同じ 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 が削除されているため、更新する必要があります。

  1. パノラマ ID の取得に使用した場所の住所または緯度と経度の座標を保存しておき、必要に応じて更新できるようにします。

  2. パノラマ 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 NOT FOUND）または無効なリクエストに対するレスポンス（400 BAD REQUEST）で、API がエラーコードを返すかどうかを示します。有効な値は true と false です。true に設定されている場合、汎用のグレー画像の代わりにエラー メッセージが返されます。これにより、イメージの可用性を確認するために個別の呼び出しを行う必要がなくなります。
  • source（デフォルトは default）: ストリートビューの検索を選択したソースに制限します。指定できる値は次のとおりです。
    • default は、ストリートビューのデフォルトのソースを使用します。検索対象が特定のソースに限定されません。
    • outdoor は、検索対象を屋外のパノラマのみに限定します。屋内コレクションは検索結果に含まれません。なお、指定された場所の屋外のパノラマが存在しない場合があります。また、検索結果には、屋内か屋外かを判断できるパノラマのみが返されます。たとえば、フォトスフィアは屋内か屋外か不明であるため、返されません。

リクエストの例を次に示します。

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 はグレーの汎用画像と「Sorry, we have no imagery here」というテキストを返します。次の例をご覧ください。

指定した場所で使用できる画像がない場合に表示される汎用画像のスクリーンショット。背景は薄茶色で、「この地域の詳細画像は表示できません」というテキストが表示されます。
図: 指定した場所で使用できる画像がない場合に表示される汎用画像。

有効な画像のみを表示する

汎用画像が表示されないようにし、ウェブページに有効な Street View Static API 画像のみを表示するには、次の推奨事項に従ってください。

  • return_error_code パラメータを true に設定します。これにより、指定した場所で使用できる画像がない場合は、Street View Static API が汎用的なグレーの画像ではなく 404 NOT FOUND エラーを返すようになります。
  • ストリートビューの画像メタデータをリクエストして、リクエストを送信する前に、指定した場所で使用できる画像があるかどうかを判断します。