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

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

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

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

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

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

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

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

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

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