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, pasa una dirección postal de EE.UU. codificada en URL o un 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 siguientes dos respuestas:
- Si el video existe,
lookupVideoMetadatamuestra 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 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 renderizó.
{
"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 puede deberse a que aún no se renderizó o a que la ubicación se encuentra en un área no admitida.
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"
}
}