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

تشير رسالة الأشكال البيانية 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"
  }
}