Si proporcionas una dirección o ID de video válidos, el
lookupVideoMetadata
muestra los metadatos asociados a un video determinado. Los metadatos en la
del cuerpo de la respuesta te permite determinar la actualidad de las imágenes, la longitud
video y también ofrece un flujo de trabajo gratuito para confirmar la existencia de videos.
Cómo usar la API
Para llamar a este extremo, pásale un código postal de EE.UU. codificado en 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,
lookupVideoMetadatamuestra los metadatos del video. - Si el video no existe, la API muestra un código de error 404.
Ejemplo de solicitud
La siguiente muestra de código solicita un video de vista aérea para la Transamerica Pyramid, ubicado 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
Los siguientes ejemplos de JSON demuestran todas las respuestas posibles al
lookupVideoMetadata solicitud.
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 hayan renderizado o porque la ubicación se encuentra en un área que no se admite.
Si la ubicación se encuentra en un tipo de
en la misma zona, puedes usar
renderVideo
para iniciar una solicitud de renderización.
{
"error": {
"code": 404,
"message": "Video not found.",
"status": "NOT_FOUND"
}
}