Avec 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 l'actualisation des images et la durée de la vidéo. Elles fournissent également un workflow sans frais 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 élément 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,
lookupVideoMetadatarenvoie 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 de vue aérienne de la Transamerica Pyramid, située au 600 Montgomery St, San Francisco, CA 94111, États-Unis.
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
Le rendu de la vidéo est déjà en cours.
{
"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. 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'établissement se trouve dans une zone couverte, vous pouvez utiliser renderVideo pour lancer une requête de rendu.
{
"error": {
"code": 404,
"message": "Video not found.",
"status": "NOT_FOUND"
}
}