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 dans le 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 de vidéos.
Utiliser l'API
Appelez ce point de terminaison en lui transmettant une adresse postale américaine encodée au format 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 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 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 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. Cela peut être dû au fait que le rendu n'a pas encore été effectué ou que le lieu se trouve dans une zone non compatible.
Si l'emplacement se trouve dans une zone disponible, vous pouvez utiliser renderVideo
pour lancer une requête de rendu.
{
"error": {
"code": 404,
"message": "Video not found.",
"status": "NOT_FOUND"
}
}