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 pour générer ou récupérer des vidéos

Suivez le workflow ci-dessous pour générer ou récupérer une vidéo de vue aérienne :

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. Le rendu peut prendre plusieurs heures. Utilisez donc un intervalle exponentiel entre les tentatives pour espacer vos appels.

3. Si la vidéo est active (lookupVideoMetadata renvoie 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 accessible à tous. 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 de 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 de vidéo pour les utiliser ultérieurement.