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

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