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

有効なアドレスまたは動画 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 にあるトランスアメリカ ピラミッドの鳥瞰図動画をリクエストします。

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