Recuperar los metadatos de un video

Si proporcionas una dirección o ID de video válidos, el lookupVideoMetadata de muestra 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 proporciona 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, lookupVideoMetadata muestra 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 estado compatible en la misma zona, puedes usar renderVideo para iniciar una solicitud de renderización.

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