با توجه به یک آدرس یا شناسه ویدیویی معتبر، روش 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"
}
}