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

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