Utiliser l'API Aerial View

L'API Aerial View prend en charge 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 une 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

Procédez comme suit pour générer ou récupérer une vidéo 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é 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. Le rendu peut prendre plusieurs heures. Veillez donc à utiliser 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 utilisateurs. Autrement dit, la 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

Conformément aux conditions spécifiques au service pour l'API Aerial View, les ID vidéo de l'API Aerial View sont exemptés des 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 les ID vidéo pour les utiliser ultérieurement.