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

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