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

Метод 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"
  }
}