אחזור המטא-נתונים של סרטון

אם ציינתם כתובת או מזהה וידאו תקינים, lookupVideoMetadata השיטה מחזירה מטא-נתונים שמשויכים לסרטון נתון. המטא-נתונים בקובץ גוף התגובה מאפשר לך לקבוע את עדכניות התמונות, אורך וידאו, וגם מספק תהליך עבודה חינמי לאישור קיומם של סרטונים.

איך משתמשים ב-API?

אפשר להפעיל את נקודת הקצה (endpoint) הזו על ידי העברת מיקוד בארה"ב בקידוד כתובת URL או כתובת videoId.

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

לאחר מכן, ה-API מחזיר אחת משתי התגובות הבאות:

• אם הסרטון קיים, lookupVideoMetadata יחזיר את המטא-נתונים של הסרטון.
• אם הסרטון לא קיים, ה-API יחזיר קוד שגיאה 404.

דוגמה לבקשה

דוגמת הקוד הבאה מבקשת סרטון תצוגה אווירית של טרנסאמריקה Pyramid, at 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"
  }
}