Создать новое видео

Метод 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 сейчас отображает ваше видео. В ответе содержится videoId , который вы можете использовать для получения видео.

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

Процесс рендеринга может занять от часа до нескольких часов. Если видео всё ещё обрабатывается, вы можете использовать lookupVideo для проверки статуса видео, пока она не вернёт состояние ACTIVE .

Для опроса отправьте запрос к lookupVideo , передав в качестве videoId . Рендеринг может занять несколько часов, поэтому используйте экспоненциальную задержку , чтобы распределить вызовы во времени.

Активный ответ

Когда renderVideo возвращает значение state ACTIVE , это означает, что видео завершило рендеринг, и вы можете получить его, вызвав lookupVideo с videoId .

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