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

Метод 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 Вт 2nd St, Остин, Техас, 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"
  }
}