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