動画のメタデータを取得する

有効な住所または videoID を指定すると、 lookupVideoMetadata メソッドは、指定された動画に関連付けられたメタデータを返します。レスポンス本文のメタデータを使用すると、画像の鮮度や動画の長さを確認できるほか、動画の存在を確認するための無料のワークフローも提供されます。

API の使用にあたっての注意事項

URL エンコードされた米国の郵便住所または videoId を渡して、このエンドポイントを呼び出します。

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?X-Goog-Api-Key=YOUR_API_KEY&address=POSTAL_ADDRESS"

API は、次のいずれかのレスポンスを返します。

• 動画が存在する場合、lookupVideoMetadata は動画のメタデータを返します。
• 動画が存在しない場合、API は 404 エラーコードを返します。

リクエスト例

次のコードサンプルは、600 Montgomery St, San Francisco, CA 94111 にあるトランスアメリカ ピラミッドの鳥瞰図動画をリクエストします。

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?X-Goog-Api-Key=YOUR_API_KEY&address=600%20Montgomery%20St%2C%20San%20Francisco%2C%20CA%2094111"

レスポンスの例

次の JSON の例は、lookupVideoMetadata リクエストに対する考えられるすべてのレスポンスを示しています。

動画が見つかりました

動画はすでにレンダリングされています。

{
  "videoId": "Ul1naoFmqo69U1zUVrQRkc",
  "captureDate": {
    "year": 2022,
    "month": 4,
    "day": 1
  },
  "duration": "40s",
  "state": "ACTIVE"
}

動画をレンダリングしています

動画をレンダリングしています。

{
  "videoId": "Ul1naoFmqo69U1zUVrQRkc",
  "state": "PROCESSING"
}

動画が見つかりません

動画が Google のデータベースにありません。これは、まだレンダリングされていないか、場所がサポートされていない地域にあることが原因である可能性があります。

場所がサポートされている 地域にある場合は、 renderVideo を使用してレンダリング リクエストを開始できます。

{
  "error": {
    "code": 404,
    "message": "Video not found.",
    "status": "NOT_FOUND"
  }
}