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

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

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

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

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

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

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

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

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

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