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

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

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

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

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

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

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

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

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

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