はじめに
Street View Static API メタデータ リクエストでは、ストリートビューのパノラマ画像に関するデータが提供されます。メタデータを使用すると、指定した場所でストリートビュー画像を取得できるかを確認できるほか、緯度と経度の座標、パノラマ ID、写真の撮影日付、および画像の著作権情報にプログラムからアクセスできます。このメタデータへのアクセスでは、アプリケーションでエラー動作をカスタマイズできます。
Street View Static API のメタデータ リクエストは無料です。メタデータをリクエストしても割り当ては消費されません。 割り当てが消費されるのは、Street View Static API を使用して画像を読み込む場合のみです。
ストリートビュー画像のメタデータ リクエストを行う場合、パノラマ画像の精度は 50 メートルです。
画像のメタデータにアクセスする
ストリートビュー画像のメタデータ リクエストは、次の形式の HTTP URL です。
https://maps.googleapis.com/maps/api/streetview/metadata?parameters
URL の標準と同様に、パラメータはすべてアンパサンド(&)文字を使用して区切ります。
メタデータ リクエストの必須パラメータ
メタデータ リクエストでは、Street View Static API の画像リクエストと同じURL パラメータを指定できますが、次のパラメータのみが必須です。
次のいずれかを実行します。
location
- テキスト文字列(Chagrin Falls, OH
など)または緯度と経度の座標のペア(40.457375,-80.009353
)のいずれかです。
または
pano
- 特定のパノラマ ID。パノラマの ID は時間の経過とともに変更される可能性があるため、この ID を保持しないでください。代わりに、パノラマ ID を更新できるように、位置情報の住所または緯度と経度の座標を保存します。詳細については、削除されたパノラマ ID を更新するをご覧ください。
さらに:
key
とsignature
- リクエストの認証に API キーが必要です。特定のインスタンスではデジタル署名も必要であり、常に推奨されます。詳細については、鍵と署名を取得するをご覧ください。
必須パラメータのみを含むメタデータ リクエストは次のようになります。
https://maps.googleapis.com/maps/api/streetview/metadata?location=&key=YOUR_API_KEY&signature=
または次のようにします。
https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&signature=
削除されたパノラマ ID を更新する
パノラマ ID の取得中に ZERO_RESULTS
または値が返されなかった場合は、パノラマ ID が削除されているため、更新する必要があります。
パノラマ ID の取得に使用した場所の住所または緯度と経度の座標を保存しておき、必要に応じて更新できるようにします。
パノラマ ID が変更されたことを検出したら、元の場所の住所または緯度と経度の座標を使用して、その場所に最も近いパノラマを再度検索し、新しいパノラマ ID を取得します。
メタデータ リクエストの省略可能パラメータ
メタデータ リクエストには、size
、heading
、fov
、pitch
のパラメータを指定できます。これらのパラメータは、パノラマ画像に関するデータや、どのパノラマ画像が検出されるかには影響しません。この API では画像リクエストと同じパラメータを指定できるため、特定の画像リクエストに関連したメタデータ リクエストを容易に作成できます。ただしメタデータ リクエストの場合、API は省略可能なパラメータとその値を無視します。これらのパラメータの使用方法については、Street View Static API デベロッパー ガイドをご覧ください。
回答の形式
メタデータのレスポンスは、JSON 形式でのみ返されます。
例
例 1: パノラマが見つかった
次の URL は、同じパノラマの画像のメタデータと画像をリクエストし、成功しています。
メタデータのリクエストとレスポンス
https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
{ "copyright" : "© 2017 Google", "date" : "2016-05", "location" : { "lat" : 48.85783227207914, "lng" : 2.295226175151347 }, "pano_id" : "tu510ie_z4ptBZYo2BGEJg", "status" : "OK" }
画像のリクエストとレスポンス。画像が欠落していることが想定されます。
https://maps.googleapis.com/maps/api/streetview?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
例 2: パノラマが見つかりません
次の URL は、パノラマ画像のメタデータと画像をリクエストしていますが、指定した場所の付近ではパノラマ画像が見つかりませんでした。
メタデータのリクエストとレスポンス
https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
{ "status" : "ZERO_RESULTS" }
画像のリクエストとレスポンス
https://maps.googleapis.com/maps/api/streetview?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
ステータス コード
メタデータ レスポンス オブジェクトの status
フィールドには、リクエストのステータスが含まれます。ストリートビュー リクエストが機能しなかった原因のトラブルシューティングに役立つデバッグ情報が含まれることもあります。status
フィールドには次の値が含まれることがあります。
ステータス | 説明 |
---|---|
"OK" |
エラーが発生しなかったことを示します。パノラマ画像が見つかり、メタデータが返されます。 |
"ZERO_RESULTS" |
指定した場所の付近ではパノラマ画像が見つからなかったことを示します。このレスポンスは、存在しないパノラマ ID または無効なパノラマ ID を指定した場合に発生することがあります。[削除されたパノラマ ID を更新する](#refresh-pano) をご覧ください。 |
"NOT_FOUND" |
location パラメータで指定した住所の文字列が見つからなかったことを示します。これは、存在しない住所を指定した場合に発生することがあります。 |
"OVER_QUERY_LIMIT" |
この API の 1 日あたりまたは 1 秒あたりの割り当てを超過したことを示します。 |
"REQUEST_DENIED" |
リクエストが拒否されたことを示します。このメッセージは、リクエストを承認しなかった場合や、API キーを含む Google Cloud コンソール プロジェクトで Street View Static API が有効になっていない場合に表示されます。 |
"INVALID_REQUEST" |
通常、クエリ パラメータ(住所、緯度と経度の座標、コンポーネント)が不足していることを示します。 |
"UNKNOWN_ERROR" |
サーバー エラーでリクエストが処理できなかったことを示します。この問題は多くの場合一時的なものです。もう一度試すと正常に処理される可能性があります。 |
詳細
Street View Static API や他の Google Maps API 製品の使用に関する詳細については、Maps API のサポートページをご覧ください。