O método
renderVideo
solicita a geração de um vídeo de visualização aérea para o endereço postal
especificado nos EUA. Se o vídeo já existir para o endereço especificado, esse método retornará metadados sobre o vídeo.
Como usar a API
Gere um novo vídeo aéreo fazendo uma solicitação HTTPS POST para o endpoint renderVideo
, transmitindo sua chave de API e um endereço postal nos EUA, conforme mostrado no exemplo a seguir. O processo de renderização pode levar de uma hora
a algumas horas.
curl -X POST -d '{ "address": "POSTAL_ADDRESS" }' \ -H 'Content-Type: application/json' \ "https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"
Exemplo de solicitação
O exemplo de código a seguir solicita a geração de um vídeo de vista aérea para 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"
Exemplo de resposta
Os exemplos de código JSON a seguir mostram as possíveis respostas à solicitação de vídeo.
Resposta de endereço inválida
O endereço está incorreto ou não está nos Estados Unidos.
{
"error": {
"code": 400,
"message": "Address not supported.",
"status": "INVALID_ARGUMENT"
}
}
Processando resposta
A API Aerial View está renderizando o vídeo. A resposta contém o
videoId
, que pode ser usado para recuperar o vídeo.
{
"state": "PROCESSING",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}
O processo de renderização pode levar de uma hora a algumas horas. Se o vídeo ainda estiver sendo processado, use lookupVideo
para pesquisar o status do vídeo até que ele retorne um estado ACTIVE
.
Para pesquisar, faça uma solicitação para lookupVideo
, transmitindo videoId
. A renderização pode
levar várias horas, portanto, use a espera
exponencial para espaçar suas chamadas.
Resposta ativa
Quando renderVideo
retorna um valor state
de ACTIVE
, isso significa que o vídeo
concluiu a renderização e é possível recuperá-lo chamando lookupVideo
com o
videoId
.
{
"state": "ACTIVE",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}