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