La méthode renderVideo demande la génération d'une vidéo de vue aérienne pour l'adresse postale spécifiée aux États-Unis. Si la vidéo existe déjà pour l'adresse spécifiée, cette méthode renvoie des métadonnées sur 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 d'une heure à 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 en vue aérienne pour 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 affiche désormais 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 de rendu peut prendre d'une heure à quelques heures. Si la vidéo est toujours en cours de traitement, vous pouvez utiliser lookupVideo pour interroger son état jusqu'à ce qu'elle renvoie l'état ACTIVE.
Pour interroger, envoyez une requête à lookupVideo, en transmettant videoId. L'affichage peut prendre plusieurs heures. Vous devez donc utiliser un intervalle exponentiel entre les tentatives pour espacer vos appels.
Réponse active
Lorsque renderVideo renvoie la valeur state de ACTIVE, cela signifie que le rendu de la vidéo est terminé. Vous pouvez la récupérer en appelant lookupVideo avec videoId.
{
"state": "ACTIVE",
"metadata": {
"videoId": "x89iJAJi1wzs7DIAFQF7Va"
}
}