Récupérer les métadonnées d'une vidéo

Étant donné une adresse ou un ID vidéo valides, la méthode lookupVideoMetadata renvoie les métadonnées associées à une vidéo donnée. Les métadonnées du corps de la réponse vous permettent de déterminer la fraîcheur des images et la durée de la vidéo. Elles fournissent également un workflow sans frais pour confirmer l'existence des vidéos.

Utiliser l'API

Appelez ce point de terminaison en lui transmettant une adresse postale américaine encodée en URL ou un videoId.

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

L'API renvoie ensuite l'une des deux réponses suivantes :

  • Si la vidéo existe, lookupVideoMetadata renvoie ses métadonnées.
  • Si la vidéo n'existe pas, l'API renvoie un code d'erreur 404.

Exemple de requête

L'exemple de code suivant demande une vidéo de vue aérienne pour la Transamerica Pyramid, située au 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"

Exemple de réponse

Les exemples JSON suivants illustrent toutes les réponses possibles à la requête lookupVideoMetadata.

Vidéo trouvée

La vidéo a déjà été traitée.

{
  "videoId": "Ul1naoFmqo69U1zUVrQRkc",
  "captureDate": {
    "year": 2022,
    "month": 4,
    "day": 1
  },
  "duration": "40s",
  "state": "ACTIVE"
}

Rendu de la vidéo en cours

Le rendu de la vidéo est en cours.

{
  "videoId": "Ul1naoFmqo69U1zUVrQRkc",
  "state": "PROCESSING"
}

Vidéo introuvable

La vidéo ne figure pas dans la base de données de Google. Cela peut être dû au fait qu'il n'a pas encore été affiché ou que l'établissement se trouve dans une zone non couverte.

Si l'emplacement se trouve dans une zone acceptée, vous pouvez utiliser renderVideo pour lancer une demande de rendu.

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