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

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

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

يمكنك إنشاء فيديو جوي جديد من خلال تقديم طلب POST لبروتوكول HTTPS إلى نقطة النهاية 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"
  }
}