Générer une nouvelle vidéo

La renderVideo demande la génération d'une vidéo aérienne pour les États-Unis spécifiés votre adresse postale. Si la vidéo existe déjà pour l'adresse spécifiée, cette renvoie des métadonnées concernant la vidéo.

Utiliser l'API

Générez une nouvelle vidéo aérienne en envoyant une requête HTTPS POST à renderVideo en transmettant votre clé API et une adresse postale aux États-Unis, dans l'exemple suivant. Le rendu peut prendre jusqu'à 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 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 vidéo requête.

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 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 La vidéo est toujours en cours de traitement, vous pouvez l'interroger à l'aide de lookupVideo jusqu'à ce qu'elle renvoie un état ACTIVE.

Pour procéder à l'interrogation, envoyez une requête à lookupVideo en transmettant videoId. Personnage de rendu peut prendre plusieurs heures. Utilisez donc un intervalle entre les tentatives pour espacer vos appels.

Réponse active

Lorsque renderVideo renvoie la valeur ACTIVE pour state, cela signifie que la vidéo a le rendu terminé, et vous pouvez le récupérer en appelant lookupVideo avec la videoId

{
  "state": "ACTIVE",
  "metadata": {
    "videoId": "x89iJAJi1wzs7DIAFQF7Va"
  }
}