استرداد البيانات الوصفية للفيديو

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

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

يمكنك استدعاء نقطة النهاية هذه من خلال تمريرها بعنوان ترميز عنوان URL postal address في الولايات المتحدة أو 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"
  }
}