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

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

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

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

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

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

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

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

نمونه کد زیر یک ویدیوی نمای هوایی برای هرم Transamerica، واقع در 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"
  }
}