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

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

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

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

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

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

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

リクエスト例

次のコードサンプルは、600 Montgomery St, San Francisco, CA 94111 にある Transamerica Pyramid の空からの動画をリクエストします。

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?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"
  }
}