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

はじめに

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=<YOUR_SIGNATURE>

または

https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>

削除されたパノラマ ID を更新する

パノラマ ID を取得しようとして ZERO_RESULTS または値なしが返された場合、パノラマ ID は削除されているため、更新する必要があります。

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

2. パノラマ ID が変更されたことを検出したら、元の場所の住所または緯度と経度の座標を使用して、その場所に最も近いパノラマを再度検索し、新しいパノラマ ID を取得します。

メタデータ リクエストの省略可能なパラメータ

メタデータ リクエストには、size、heading、fov、pitch のパラメータを含めることができます。これらのパラメータは、パノラマに関するデータや、どのパノラマが見つかるかに影響しません。API では、画像リクエストと同じパラメータを含めることができるため、特定の画像リクエストに関連するメタデータ リクエストを簡単に作成できますが、メタデータ リクエストの場合、API は省略可能なパラメータとその値を無視します。これらのパラメータの使用方法については、ストリートビュー静止画像 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 フィールドには次の値が含まれることがあります。

詳細

Street View Static API やその他の Google Maps API プロダクトの使用について詳しくは、Maps API のサポートページをご覧ください。