Com um endereço ou ID de vídeo válido, o
lookupVideoMetadata
retorna metadados associados a um determinado vídeo. Os metadados na
o corpo da resposta permite determinar se as imagens são recentes, o comprimento
e também fornece um fluxo de trabalho sem custo financeiro para confirmar a existência de vídeos.
Como usar a API
Chame esse endpoint transmitindo um código postal dos EUA codificado em URL
um endereço IP 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 com vista aérea da região Transamerica Pirâmide, localizada na 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 de JSON a seguir demonstram todas as respostas possíveis para os
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 acontecido porque ele ainda não foram renderizados ou porque o local está em uma área sem suporte.
Se o local estiver em um ambiente
área, é possível usar
renderVideo
para iniciar uma solicitação de renderização.
{
"error": {
"code": 404,
"message": "Video not found.",
"status": "NOT_FOUND"
}
}