Cómo recuperar los metadatos de un video

Dado un videoID o una dirección válidos, el lookupVideoMetadata método muestra los metadatos asociados con un video determinado. Los metadatos en el 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

Para llamar a este extremo, debes pasarle una dirección postal de EE.UU. codificada como URL o un videoId.

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

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

• Si el video existe, lookupVideoMetadata muestra 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 Transamérica, ubicada en 600 Montgomery St, San Francisco, CA 94111.

curl -X GET "https://aerialview.googleapis.com/v1/videos:lookupVideoMetadata?X-Goog-Api-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 admitida, puedes usar renderVideo para iniciar una solicitud de renderización.

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