فراداده یک ویدیو را بازیابی کنید

با داشتن یک آدرس یا videoID معتبر، متد lookupVideoMetadata فراداده‌های مرتبط با یک ویدیوی داده شده را برمی‌گرداند. فراداده‌های موجود در بدنه پاسخ به شما امکان می‌دهند تازگی تصاویر، طول ویدیو را تعیین کنید و همچنین یک گردش کار رایگان برای تأیید وجود ویدیوها فراهم می‌کند.

نحوه استفاده از API

با ارسال یک آدرس پستی ایالات متحده کدگذاری شده با URL یا یک videoId ، این نقطه پایانی را فراخوانی کنید.

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

سپس API یکی از دو پاسخ زیر را برمی‌گرداند:

• اگر ویدیو وجود داشته باشد، تابع lookupVideoMetadata متادیتای ویدیو را برمی‌گرداند.
• اگر ویدیو وجود نداشته باشد، API کد خطای ۴۰۴ را برمی‌گرداند.

درخواست نمونه

نمونه کد زیر، یک ویدیوی نمای هوایی از هرم ترانس آمریکا، واقع در خیابان مونتگومری ۶۰۰، سانفرانسیسکو، کالیفرنیا ۹۴۱۱۱، درخواست می‌کند.

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

ویدیو یافت نشد

این ویدیو در پایگاه داده گوگل وجود ندارد. این می‌تواند به این دلیل باشد که یا هنوز رندر نشده است، یا به این دلیل که مکان در منطقه‌ای است که پشتیبانی نمی‌شود.

اگر مکان در یک منطقه پشتیبانی‌شده باشد، می‌توانید renderVideo برای شروع یک درخواست رندر استفاده کنید.

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