Utiliser l'API Aerial View

L'API Aerial View est compatible avec deux workflows généraux. Votre approche dépend de l'existence ou non de la vidéo que vous demandez. Si vous n'êtes pas sûr que la vidéo existe, vous devez utiliser lookupVideoMetadata pour déterminer son état.

Workflow de génération ou de récupération de vidéos

Pour générer ou récupérer une vidéo en vue aérienne, suivez le workflow suivant:

1. Vérifiez si Google a déjà généré une vidéo pour l'établissement à l'aide de lookupVideoMetadata.
2. Si aucune vidéo n'existe (lookupVideoMetadata a renvoyé un code 404), appelez renderVideo pour générer une nouvelle vidéo.
   1. Appelez lookupVideoMetadata à l'aide de videoId ou de l'adresse pour interroger le point de terminaison jusqu'à ce que l'état de la vidéo soit ACTIVE. L'affichage peut prendre plusieurs heures. Utilisez donc un intervalle exponentiel entre les tentatives pour espacer vos appels.

3. Si la vidéo est active (lookupVideoMetadata a renvoyé un état ACTIVE), appelez lookupVideo pour récupérer les URI de la vidéo.

   Remarque :Une fois que Google a généré la vidéo pour une adresse spécifique, elle est disponible pour tous les internautes. Autrement dit, une vidéo n'est pas associée à un utilisateur ou à un compte spécifique.

Ce workflow est représenté dans le schéma ci-dessous:

Enregistrer des ID de vidéo pour une utilisation ultérieure

Conformément aux conditions spécifiques du service pour l'API Vue aérienne, les ID vidéo de l'API Vue aérienne ne sont pas soumis aux restrictions de mise en cache stipulées dans la section 3.2.3(b)(Aucune mise en cache) des conditions d'utilisation de Google Maps Platform. Vous pouvez donc stocker des valeurs d'ID vidéo pour les utiliser ultérieurement.