Cómo recuperar los metadatos de un video

Dado un videoID o una dirección válidos, el método lookupVideoMetadata devuelve los metadatos asociados con un video determinado. Los metadatos del cuerpo de la respuesta te permiten determinar la actualidad de las imágenes, la duración del video y también proporcionan un flujo de trabajo gratuito para confirmar la existencia de videos.

Cómo usar la API

Llama a este extremo pasando una dirección postal de EE.UU. codificada como URL o un videoId.

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?key=YOUR_API_KEY&address=POSTAL_ADDRESS"

Luego, la API devuelve una de las siguientes dos respuestas:

• Si el video existe, lookupVideoMetadata devuelve sus metadatos.
• Si el video no existe, la API devuelve un código de error 404.

Ejemplo de solicitud

En la siguiente muestra de código, se solicita un video con vista aérea de la Pirámide Transamérica, 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ó el 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 podría 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 se encuentra en un área compatible, puedes usar renderVideo para iniciar una solicitud de renderización.

{
  "error": {
    "code": 404,
    "message": "Video not found.",
    "status": "NOT_FOUND"
  }
}