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

有効なアドレスまたは videoID が指定されると、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 にあるトランスアメリカ ピラミッドの空撮動画をリクエストします。

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"
  }
}