Si el ID de video o la dirección son válidos, el método lookupVideoMetadata mostrará los metadatos asociados con un video específico. Los metadatos del cuerpo de la respuesta te permiten determinar la actualidad de las imágenes y la duración del video, y también proporcionan 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 como una URL o un código 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 sus metadatos. - 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 demuestran 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 porque 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"
}
}