Utiliser l'API Aerial View

L'API Aerial View est compatible avec deux workflows généraux. Votre approche varie selon que la vidéo que vous demandez existe ou non. Si vous ne savez pas si la vidéo existe, vous devez utiliser lookupVideoMetadata pour déterminer son état.

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

Procédez comme suit pour générer ou récupérer une vidéo en vue aérienne:

1. Vérifiez si Google a déjà généré une vidéo pour le lieu à l'aide de lookupVideoMetadata.
2. S'il n'existe aucune vidéo (lookupVideoMetadata a renvoyé une erreur 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. Vous devez donc utiliser un intervalle exponentiel entre les tentatives pour espacer vos appels.

3. Si la vidéo est active (lookupVideoMetadata a renvoyé l'é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 utilisateurs. Autrement dit, une vidéo n'est associée à aucun utilisateur ni compte spécifique.

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

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

Sous réserve des conditions spécifiques au service pour l'API Aerial View, les ID vidéo de l'API Aerial View ne sont pas soumis aux restrictions de mise en cache stipulées dans la section 3.2.3(b)(Pas de mise en cache) des conditions d'utilisation de Google Maps Platform. Vous pouvez donc stocker des ID vidéo pour les utiliser ultérieurement.