Gerar um novo vídeo

O renderVideo método solicita a geração de um vídeo de vista aérea para o endereço postal dos EUA especificado. Se o vídeo já existir para o endereço especificado, esse método retornará metadados sobre o vídeo.

Observação: esse uso de renderVideo pressupõe que o Google ainda não gerou o vídeo de vista aérea de que você precisa. Ou seja, é necessário gerar um novo vídeo de vista aérea.

Como usar a API

Gere um novo vídeo aéreo fazendo uma solicitação HTTPS POST para o renderVideo endpoint, transmitindo 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 a algumas horas.

**Observação** :não há custo para usar esse endpoint.

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 de exemplo.

Resposta de endereço inválido

O endereço está incorreto ou não está nos Estados Unidos.

{
  "error": {
    "code": 400,
    "message": "Address not supported.",
    "status": "INVALID_ARGUMENT"
  }
}

Resposta de processamento

A API Aerial View agora 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 vídeo ainda estiver sendo processado, use lookupVideo para consultar o status do vídeo até que ele retorne um estado de ACTIVE.

Para consultar, faça uma solicitação para lookupVideo, transmitindo o videoId. A renderização pode levar várias horas. Use a retirada exponencial para espaçar as chamadas.

Resposta ativa

Quando renderVideo retorna um valor state de ACTIVE, isso significa que o vídeo terminou a renderização e você pode recuperá-lo chamando lookupVideo com o videoId.

{
  "state": "ACTIVE",
  "metadata": {
    "videoId": "x89iJAJi1wzs7DIAFQF7Va"
  }
}