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

روش 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"
  }
}

در حال پردازش پاسخ

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

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

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

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

پاسخ فعال

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

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