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

有効なアドレスまたは 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, 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 のデータベースに登録されていない。原因としては、Google Cloud のプロジェクトと サポートされていない地域にあるため。

場所がサポートされている 範囲） renderVideo レンダリングリクエストを開始します

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