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

Pour 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, la durée de la vidéo et de fournir un workflow gratuit pour confirmer l'existence de 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 en vue aérienne de la pyramide Transamerica, 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é générée.

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

Rendu de la vidéo

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'emplacement se trouve dans une zone non prise en charge.

Si l'emplacement se trouve dans une zone géographique acceptée, vous pouvez utiliser renderVideo pour lancer une requête de rendu.

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