このページは Cloud Translation API によって翻訳されました。

ストリートビュー画像のメタデータ

はじめに

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 のサポートページをご覧ください。