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

Street View Image リクエストは、次の形式の HTTP URL です。

https://maps.googleapis.com/maps/api/streetview?parameters

画像はリクエスト パラメータを使用して指定します。Google Cloud の標準 すべてのパラメータはアンパサンド（&）文字で区切ります。 使用可能なパラメータとその有効な値のリストを次に示します。

必須パラメータ

次のいずれかを実行します。

  • 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 を更新するをご覧ください。

さらに:

  • size には、画像の出力サイズをピクセル単位で指定します。サイズは次のように指定します。 {width}x{height} - 例: size=600x400 このクエリは、幅 600 ピクセル、高さ 400 ピクセルの画像を返します。
  • key を使用すると、 Google Cloud コンソール を確認し、必要に応じて 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 は、API が返す必要があるかどうかを示します。 画像が見つからない場合（404 NOT FOUND）、または リクエストが無効です（400 BAD REQUEST）。有効な値は 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 が返されます。 エラーが表示されます。 表示されます。
  • ストリートビュー画像のメタデータをリクエストする 以前、指定した場所で利用可能な画像があるかどうかを リクエストを送信できます。