אם מזינים כתובת או מזהה וידאו תקינים, השיטה 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"
}
}