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

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

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

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

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

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

رسم بياني يعرض سير العمل الموضّح أعلاه

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

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