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

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

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

وعليك باستدعاء نقطة النهاية هذه من خلال إضافة عنوان بريدي في الولايات المتحدة بترميز عنوان URL أو videoId.

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

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

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

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

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