A
renderVideo
solicita a geração de um vídeo com vista aérea para os EUA especificados
endereço postal. Se o vídeo já existe para o endereço especificado, este
retorna metadados sobre o vídeo.
Como usar a API
Gere um novo vídeo aéreo fazendo uma solicitação POST HTTPS para o
renderVideo
endpoint, passando sua chave de API e um endereço postal dos EUA, conforme mostrado
no exemplo a seguir. O processo de renderização pode levar de uma hora
de 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 com vista aérea para 500 W 2nd St, Austin, Texas, 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 para o vídeo de exemplo solicitação.
Resposta inválida de endereço
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 seu 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
o vídeo ainda está sendo processado, use lookupVideo
para verificar o status do vídeo
até retornar um estado de ACTIVE
.
Para pesquisar, faça uma solicitação para lookupVideo
, transmitindo videoId
. A renderização pode
levar várias horas, então use exponencial
em espera para espaçar as chamadas.
Resposta ativa
Quando renderVideo
retorna um valor state
de ACTIVE
, significa que o vídeo
quando a renderização for concluída, e você pode recuperá-la chamando lookupVideo
com o
videoId
.
{
"state": "ACTIVE",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}