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

Si l'adresse ou l'ID vidéo sont valides, lookupVideoMetadata renvoie les métadonnées associées à une vidéo donnée. Les métadonnées de la section Le corps de la réponse vous permet de déterminer la fraîcheur des images, la longueur des vidéo et propose un workflow sans frais pour confirmer l'existence de vidéos.

Utiliser l'API

Appelez ce point de terminaison en lui transmettant un code postal américain encodé en URL. adresse e-mail ou 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 déjà, lookupVideoMetadata renvoie les métadonnées de la vidéo.
• 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 aérienne pour la région Transamerica Pyramid, situé 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 au lookupVideoMetadata.

Vidéo trouvée

Le rendu de la vidéo a déjà été effectué.

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

Le rendu de la vidéo est 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. Il se peut qu'il n'ait pas encore ou parce que le lieu se trouve dans une zone non prise en charge.

Si le lieu se trouve dans un , vous pouvez utiliser renderVideo pour lancer une demande de rendu.

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