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

عند تقديم عنوان أو معرّف فيديو صالحَين، تعرض الطريقة 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"
  }
}