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

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