Si se proporciona una dirección o un ID de video válidos, el método lookupVideoMetadata muestra los metadatos asociados con un video determinado. Los metadatos del cuerpo de la respuesta te permiten determinar la actualidad de las imágenes y la duración del video. Además, ofrecen un flujo de trabajo gratuito para confirmar la existencia de los videos.
Cómo usar la API
Para llamar a este extremo, pásale una dirección postal de EE.UU. codificada en formato URL o una videoId.
curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=POSTAL_ADDRESS "
Luego, la API muestra una de las dos respuestas siguientes:
- Si el video existe,
lookupVideoMetadatadevuelve los metadatos del video. - Si el video no existe, la API muestra un código de error 404.
Ejemplo de solicitud
En la siguiente muestra de código, se solicita un video de vista aérea de la Pirámide de Transamerica, ubicada en 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"
Ejemplo de respuesta
En los siguientes ejemplos de JSON, se muestran todas las respuestas posibles a la solicitud lookupVideoMetadata.
Se encontró un video
El video ya se procesó.
{
"videoId": "Ul1naoFmqo69U1zUVrQRkc",
"captureDate": {
"year": 2022,
"month": 4,
"day": 1
},
"duration": "40s",
"state": "ACTIVE"
}
Se está renderizando el video
Se está renderizando el video.
{
"videoId": "Ul1naoFmqo69U1zUVrQRkc",
"state": "PROCESSING"
}
No se encontró el video
El video no está en la base de datos de Google. Esto podría deberse a que aún no se renderizó o a que la ubicación está en un área que no se admite.
Si la ubicación está en un área compatible, puedes usar renderVideo para iniciar una solicitud de renderización.
{
"error": {
"code": 404,
"message": "Video not found.",
"status": "NOT_FOUND"
}
}