はじめに
Street View Static API のメタデータ リクエストでは、ストリートに関するデータが提供されます。 パノラマを表示します。メタデータを使用すると、ストリートビューの画像が 特定の場所での利用可能なリソースだけでなく、プログラムから 緯度と経度の座標、パノラマ ID、写真の日付 画像の著作権情報が含まれます。これにアクセスする metadata を使用すると、アプリケーションのエラーの動作をカスタマイズできます。
Street View Static API のメタデータ リクエストは、 。メタデータをリクエストしても、割り当ては消費されません。 <ph type="x-smartling-placeholder"></ph> 割り当てが消費されるのは、 Street View Static API。
ストリートビュー画像のメタデータ リクエストを行う場合、パノラマ画像は 50 メートルの精度があります。
画像のメタデータにアクセスする
ストリートビュー画像のメタデータ リクエストは、次の形式の HTTP URL です。
https://maps.googleapis.com/maps/api/streetview/metadata?parameters
URL の標準と同様に、すべてのパラメータはアンパサンドを使用して区切ります。 (&)文字を使用できます。
メタデータ リクエストの必須パラメータ
メタデータ リクエストは、 Street View Static API 画像リクエストとほぼ同じですが、 次のパラメータが必要です。
次のいずれかを実行します。
location
- テキスト文字列(Chagrin Falls, OH
など)のいずれか またはカンマ区切りの緯度と経度の座標ペア(40.457375,-80.009353
)を指定できます。
または
pano
- 特定のパノラマ ID。パノラマは時間の経過とともに ID が変更されることがあるため、 保持しないでください。代わりに、場所の住所を保存するか、 緯度と経度の座標。パノラマ ID を更新できるようにします。対象 詳しくは、削除されたパノラマの ID を更新するをご覧ください。
さらに:
key
とsignature
- 認証に API キーが必要です。 リクエストできます。デジタル署名が必要な場合もあります。 おすすめします。詳細については、次をご覧ください: 鍵と署名を取得する
必須パラメータのみを含むメタデータ リクエストは、次のようになります。
https://maps.googleapis.com/maps/api/streetview/metadata?location=&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>
または次のような形式にします。
https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&signature=<YOUR_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-hyperparameter)をご覧ください。 |
"NOT_FOUND" |
location で提供される住所文字列が
パラメータが見つかりませんでした。このメッセージは、アドレスが存在しない場合に発生することがあります。
与えられます。 |
"OVER_QUERY_LIMIT" |
1 日の割り当てまたは 1 秒あたりの割り当てを超過したことを示します 使用します。 |
"REQUEST_DENIED" |
リクエストが拒否されたことを示します。このメッセージは、 リクエストを承認しない場合、または Street View Static API が API キーを含む Google Cloud Console プロジェクト。 |
"INVALID_REQUEST" |
通常、クエリ パラメータ(住所、 緯度と経度の座標、コンポーネントなど)が指定されていません。 |
"UNKNOWN_ERROR" |
サーバーエラーが原因でリクエストが処理できなかったことを示します。 多くの場合、この問題は一時的なものです。もう一度試すと正常に処理される可能性があります。 |
詳細
Street View Static API の使用方法について詳しくは、 Google Maps API の詳細については、Maps API の サポートページ。