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

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

はじめに

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=

または次のような形式にします。

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-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 のサポートページ。