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

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

בקשה לדוגמה

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