Recuperar metadados de um vídeo

Com um endereço ou ID de vídeo válido, o método lookupVideoMetadata retorna metadados associados a um determinado vídeo. Os metadados no corpo da resposta permitem determinar se as imagens são recentes e a duração do vídeo, além de fornecer um fluxo de trabalho sem custo financeiro para confirmar a existência de vídeos.

Como usar a API

Chame esse endpoint transmitindo um endereço postal dos EUA codificado em URL ou um videoId.

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=POSTAL_ADDRESS"

Em seguida, a API retorna uma das duas respostas a seguir:

• Se o vídeo existir, lookupVideoMetadata retornará os metadados dele.
• Se o vídeo não existir, a API retornará um código de erro 404.

Exemplo de solicitação

O exemplo de código a seguir solicita um vídeo de vista aérea da Pirâmide Transamérica, localizada em 600 Montgomery St, São Francisco, CA 94111.

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=600%20Montgomery%20St%2C%20San%20Francisco%2C%20CA%2094111"

Exemplo de resposta

Os exemplos JSON a seguir demonstram todas as respostas possíveis à solicitação lookupVideoMetadata.

Vídeo encontrado

O vídeo já foi renderizado.

{
  "videoId": "Ul1naoFmqo69U1zUVrQRkc",
  "captureDate": {
    "year": 2022,
    "month": 4,
    "day": 1
  },
  "duration": "40s",
  "state": "ACTIVE"
}

O vídeo está sendo renderizado

O vídeo está sendo renderizado.

{
  "videoId": "Ul1naoFmqo69U1zUVrQRkc",
  "state": "PROCESSING"
}

Vídeo não encontrado

O vídeo não está no banco de dados do Google. Isso pode ter ocorrido porque ele ainda não foi renderizado ou porque o local está em uma área sem suporte.

Se o local estiver em uma área compatível, use renderVideo para iniciar uma solicitação de renderização.

{
  "error": {
    "code": 404,
    "message": "Video not found.",
    "status": "NOT_FOUND"
  }
}