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

تطلب الطريقة 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"
  }
}