كيفية استخدام Aerial View API

تتيح Aerial View API سيرَي عمل عامَّين. تعتمد الطريقة التي تتّبعها على ما إذا كان الفيديو الذي تطلبه متوفّرًا أم لا. إذا لم تكن متأكدًا مما إذا كان الفيديو متوفّرًا، عليك استخدام lookupVideoMetadata لتحديد حالة الفيديو.

سير العمل لإنشاء الفيديوهات أو استردادها

اتّبِع سير العمل التالي لإنشاء فيديو يظهر فيه المنظر الجوي أو استرداده:

1. تحقَّق مما إذا أنشأت Google فيديو للموقع الجغرافي باستخدام lookupVideoMetadata.
2. إذا لم يكن هناك فيديو (عرض الرمز lookupVideoMetadata الخطأ 404)، يمكنك طلب إنشاء فيديو جديد من خلال استدعاء الدالة renderVideo.
   1. اتّصِل بـ lookupVideoMetadata باستخدام videoId أو العنوان لاستطلاع نقطة النهاية إلى أن تصبح حالة الفيديو ACTIVE. قد تستغرق عملية العرض عدة ساعات، لذا استخدِم التراجع الأسي لتباعد طلباتك.

3. إذا كان الفيديو نشطًا (عرضت lookupVideoMetadata الحالة ACTIVE)، اتّصِل بالدالة lookupVideo لجلب معرّفات الموارد الموحّدة للفيديو.

   ملاحظة: بعد أن تنشئ Google فيديو خاصًا بعنوان معيّن، يصبح هذا الفيديو متاحًا للجميع. أي أنّ الفيديو لا يكون مرتبطًا بمستخدم أو حساب معيّنَين.

يتم تمثيل سير العمل هذا في الرسم البياني أدناه:

حفظ أرقام تعريف الفيديوهات لاستخدامها لاحقًا

بموجب بنود الخدمة المحدّدة في Aerial View API، تكون معرّفات الفيديو في Aerial View API معفاة من قيود التخزين المؤقت الواردة في الفقرة 3.2.3(ب)(عدم التخزين المؤقت) من بنود خدمة "منصة خرائط Google". وبالتالي، يمكنك تخزين قيم معرّفات الفيديوهات لاستخدامها لاحقًا.