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

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

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

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

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

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

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

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

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

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