یک ویدیوی جدید ایجاد کنید

متد renderVideo درخواست تولید یک ویدیوی نمای هوایی برای آدرس پستی مشخص شده در ایالات متحده را می‌دهد. اگر ویدیو از قبل برای آدرس مشخص شده وجود داشته باشد، این متد متادیتای مربوط به ویدیو را برمی‌گرداند.

نحوه استفاده از API

با ارسال یک درخواست HTTPS POST به نقطه پایانی renderVideo ، و ارسال کلید API و آدرس پستی ایالات متحده، همانطور که در مثال زیر نشان داده شده است، یک ویدیوی هوایی جدید ایجاد کنید. فرآیند رندر می‌تواند از یک ساعت تا چند ساعت طول بکشد.

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"
  }
}

پردازش پاسخ

API نمای هوایی (Aerial View API) اکنون ویدیوی شما را رندر می‌کند. پاسخ شامل videoId است که می‌توانید برای بازیابی ویدیو از آن استفاده کنید.

{
  "state": "PROCESSING",
  "metadata": {
    "videoId": "x89iJAJi1wzs7DIAFQF7Va"
  }
}

فرآیند رندرینگ می‌تواند از یک ساعت تا چند ساعت طول بکشد. اگر ویدیو هنوز در حال پردازش است، می‌توانید lookupVideo برای نظرسنجی از وضعیت ویدیو تا زمان بازگشت وضعیت ACTIVE استفاده کنید.

برای نظرسنجی، درخواستی به lookupVideo ارسال کنید و videoId را ارسال کنید. رندر کردن می‌تواند چندین ساعت طول بکشد، بنابراین از backoff نمایی برای فاصله‌گذاری بین فراخوانی‌های خود استفاده کنید.

پاسخ فعال

وقتی renderVideo مقدار state برابر با ACTIVE را برمی‌گرداند، به این معنی است که رندر ویدیو به پایان رسیده است و می‌توانید با فراخوانی تابع lookupVideo به همراه videoId آن را بازیابی کنید.

{
  "state": "ACTIVE",
  "metadata": {
    "videoId": "x89iJAJi1wzs7DIAFQF7Va"
  }
}