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

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

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

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

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

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

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

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

تطلب عينة التعليمات البرمجية التالية فيديو لتصوير جوّي لبرج Transamerica Pyramid، الذي يقع في ‎600 Montgomery St, San Francisco, CA 94111.

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?X-Goog-Api-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"
  }
}