La méthode renderVideo demande la génération d'une vidéo aérienne pour l'adresse postale américaine spécifiée. Si la vidéo existe déjà pour l'adresse spécifiée, cette méthode renvoie les métadonnées associées à la vidéo.
Utiliser l'API
Générez une nouvelle vidéo aérienne en envoyant une requête HTTPS POST au point de terminaison renderVideo, en transmettant votre clé API et une adresse postale aux États-Unis, comme illustré dans l'exemple suivant. Le processus de rendu peut prendre entre une heure et quelques heures.
curl -X POST -d '{
"address": "POSTAL_ADDRESS"
}' \
-H 'Content-Type: application/json' \
"https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"
Exemple de requête
L'exemple de code suivant demande la génération d'une vidéo aérienne pour le 500 W 2nd St, Austin, TX, 78701.
curl -X POST -d '{
"address": "500 W 2nd St, Austin, TX 78701"
}' \
-H 'Content-Type: application/json' \
"https://aerialview.googleapis.com/v1/videos:renderVideo?key=YOUR_API_KEY"
Exemple de réponse
Les exemples de code JSON suivants montrent les réponses possibles à l'exemple de requête vidéo.
Réponse d'adresse incorrecte
L'adresse est incorrecte ou elle n'est pas située aux États-Unis.
{
"error": {
"code": 400,
"message": "Address not supported.",
"status": "INVALID_ARGUMENT"
}
}
Traitement de la réponse...
L'API Aerial View effectue actuellement le rendu de votre vidéo. La réponse contient le videoId, que vous pouvez utiliser pour récupérer la vidéo.
{
"state": "PROCESSING",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}
Le processus d'affichage peut prendre entre une heure et quelques heures. Si le traitement de la vidéo est toujours en cours, vous pouvez utiliser lookupVideo pour l'interroger jusqu'à ce qu'il renvoie l'état ACTIVE.
Pour procéder à l'interrogation, envoyez une requête à lookupVideo en transmettant videoId. Le rendu peut prendre plusieurs heures. Veillez donc à utiliser un intervalle exponentiel entre les tentatives pour espacer vos appels.
Réponse active
Lorsque renderVideo renvoie la valeur state ACTIVE, cela signifie que le rendu de la vidéo est terminé. Vous pouvez le récupérer en appelant lookupVideo avec le videoId.
{
"state": "ACTIVE",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}