كيفية استخدام 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 Maps Platform. وبالتالي، يمكنك تخزين قيم معرّفات الفيديوهات لاستخدامها لاحقًا.