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

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