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

يطلب الإجراء 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"
  }
}