استرداد البيانات الوصفية لمقطع فيديو

من خلال إدخال عنوان أو معرف فيديو صالح، lookupVideoMetadata البيانات الوصفية المرتبطة بفيديو معين. بيانات التعريف في تحديد حداثة الصور وطول الفيديو، وتوفر أيضًا سير عمل مجانيًا لتأكيد وجود مقاطع الفيديو.

كيفية استخدام واجهة برمجة التطبيقات

وعليك طلب نقطة النهاية هذه من خلال تمريرها كرمز بريد أمريكي بترميز عنوان URL. العنوان أو videoId

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

بعد ذلك، تعرض واجهة برمجة التطبيقات أحد الردَين التاليَين:

• إذا كان الفيديو متوفّرًا، تعرض lookupVideoMetadata البيانات الوصفية الخاصة به.
• إذا لم يكن الفيديو متوفّرًا، ستعرض واجهة برمجة التطبيقات رمز الخطأ 404.

مثال على الطلب

يطلب نموذج التعليمة البرمجية التالي فيديو لعرض جوي لـ Transamerica هرم، يقع في 600 شارع مونتغمري، سان فرانسيسكو، كاليفورنيا 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"
  }
}