Com um endereço ou ID de vídeo válido, o método
lookupVideoMetadata
retorna os metadados associados a um determinado vídeo. Os metadados no
corpo da resposta permitem determinar a atualização das imagens 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 "
A API retorna uma das duas respostas a seguir:
- Se o vídeo existir,
lookupVideoMetadata
vai 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 Transamerica, localizada em 600 Montgomery St, San 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 de 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 acontecer porque o recurso 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"
}
}