إنشاء فيديو جديد

تطلب الطريقة renderVideo إنشاء فيديو يعرض صورًا جوية لعنوان بريدي محدّد في الولايات المتحدة. إذا كان الفيديو متوفّرًا مسبقًا على العنوان المحدّد، ستعرض هذه الطريقة البيانات الوصفية الخاصة بالفيديو.

كيفية استخدام واجهة برمجة التطبيقات

أنشئ فيديو جويًا جديدًا من خلال إرسال طلب HTTPS POST إلى نقطة النهاية renderVideo، مع تمرير مفتاح واجهة برمجة التطبيقات وعنوان بريدي أمريكي، كما هو موضّح في المثال التالي. قد تستغرق عملية العرض من ساعة إلى بضع ساعات.

curl -X POST -d '{
  "address": "POSTAL_ADDRESS"
}' \
-H 'Content-Type: application/json' \
"https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"

مثال على الطلب

يطلب مثال الرمز التالي إنشاء فيديو لعرض جوي للعنوان 500 W 2nd St, Austin, TX, 78701.

curl -X POST -d '{
  "address": "500 W 2nd St, Austin, TX 78701"
}' \
-H 'Content-Type: application/json' \
"https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"

مثال على إجابة

تعرض نماذج رمز JSON التالية الردود المحتملة على طلب الفيديو النموذجي.

ردّ غير صالح على العنوان

العنوان غير صحيح أو ليس في الولايات المتحدة.

{
  "error": {
    "code": 400,
    "message": "Address not supported.",
    "status": "INVALID_ARGUMENT"
  }
}

ردّ المعالجة

تعرض واجهة برمجة التطبيقات Aerial View API الفيديو الآن. يتضمّن الردّ videoId، الذي يمكنك استخدامه لاسترداد الفيديو.

{
  "state": "PROCESSING",
  "metadata": {
    "videoId": "x89iJAJi1wzs7DIAFQF7Va"
  }
}

يمكن أن تستغرق عملية العرض من ساعة إلى بضع ساعات. إذا كان الفيديو لا يزال قيد المعالجة، يمكنك استخدام lookupVideo للاستعلام عن حالة الفيديو إلى أن يتم عرض الحالة ACTIVE.

لإجراء استطلاع، أرسِل طلبًا إلى lookupVideo، مع تمرير videoId. قد تستغرق عملية العرض عدة ساعات، لذا استخدِم التراجع الأسي لتباعد طلباتك.

الردّ النشط

عندما تعرض renderVideo القيمة state التي تساوي ACTIVE، يعني ذلك أنّ الفيديو قد انتهى من العرض، ويمكنك استرداده من خلال استدعاء lookupVideo باستخدام videoId.

{
  "state": "ACTIVE",
  "metadata": {
    "videoId": "x89iJAJi1wzs7DIAFQF7Va"
  }
}