Ajouter une clé API Google Maps pour voler partout dans le monde

Simulateur FPVSIMCartes9:42
Regarder sur YouTube

Créez et ajoutez une clé API Google Maps pour accéder aux lieux du monde réel dans le mode World Flight de FPVSIM.

Ce que vous apprendrez

Ce tutoriel relie un projet personnel Google Maps Platform à la scène de vol dans le monde réel de FPVSIM. Vous créez un projet cloud dédié, activez Map Tiles API, générez une clé avec des restrictions, l’enregistrez dans FPVSIM, puis chargez un lieu réel pour y voler virtuellement en FPV.

Ne copiez jamais une clé montrée dans une ancienne vidéo, une capture d’écran, un commentaire ou un dépôt public. Créez votre propre clé avec des restrictions. La clé de démonstration était temporaire ; toute clé rendue publique doit être révoquée et remplacée.

Avant de commencer

  • Un compte Google permettant d’accéder à Google Cloud Console.
  • L’autorisation de créer un projet, de configurer Maps Platform et de satisfaire aux exigences actuelles de facturation ou de vérification de compte.
  • L’accès à FPVSIM et une connexion Internet stable pour charger les tuiles cartographiques à la demande.
  • Du temps pour consulter les tarifs, quotas et conditions actuels de Google : la console et les règles ont pu changer depuis cet enregistrement de 2023.

Créer la clé de manière sécurisée

  1. Créer un projet cloud dédié

    Connectez-vous à Google Cloud Console et créez un projet réservé aux tuiles cartographiques de FPVSIM. Un projet dédié facilite la gestion de l’utilisation, des restrictions et de la révocation.

  2. Effectuer la configuration actuelle du compte

    Suivez les instructions actuelles de Google pour configurer le compte et la facturation. Ne vous fiez pas aux anciennes indications de gratuité ou de quotas de la vidéo : vérifiez les conditions affichées dans votre console.

  3. Activer Map Tiles API

    Ouvrez la bibliothèque d’API, recherchez Map Tiles API, sélectionnez-la et activez-la pour le nouveau projet.

  4. Créer une clé API

    Ouvrez la rubrique des identifiants et créez une clé API. Traitez cette valeur comme un secret, même si une intégration dans le navigateur peut la transmettre depuis le client.

  5. Restreindre la clé

    Limitez la clé à Map Tiles API et appliquez la restriction d’application la plus étroite compatible avec votre utilisation de FPVSIM. N’autorisez que les origines ou applications nécessaires et ne réutilisez pas cette clé pour d’autres projets.

  6. Ajouter des contrôles de coût

    Examinez les quotas et configurez les alertes de budget ou d’utilisation lorsqu’elles sont disponibles. Revérifiez ces contrôles chaque fois que Google modifie les tarifs ou les limites de Maps Platform.

Charger un lieu réel dans FPVSIM

  1. Ouvrir la scène de vol dans le monde réel

    Lancez FPVSIM, choisissez « Quick Play », puis ouvrez la scène Google Earth ou basée sur Google Maps qui se trouve à la fin de la liste des scènes.

  2. Saisir votre propre clé

    Collez la clé que vous venez de créer dans le champ de clé API et enregistrez-la. Ne collez pas une clé copiée depuis ce tutoriel ou tout autre tutoriel public.

  3. Attendre le chargement des tuiles

    La scène commence à demander les tuiles cartographiques après l’enregistrement de la clé. Si la caméra démarre sous la surface, rechargez la scène ou entrez-y de nouveau, comme dans la démonstration.

  4. Choisir un lieu et voler

    Rejoignez le lieu que vous souhaitez explorer et commencez à voler. Les détails des tuiles peuvent apparaître progressivement, notamment si la connexion est lente.

Conseils de sécurité et de dépannage

  • Si une clé est exposée, révoquez-la dans Google Cloud Console et créez-en une nouvelle, plutôt que d’essayer de masquer l’ancienne valeur après coup.
  • Un monde vide ou partiellement chargé peut indiquer que l’API est désactivée, que les restrictions ne correspondent pas à la requête, que le quota est épuisé, que la facturation est inactive ou que le réseau est lent.
  • Après une session, consultez l’utilisation du projet pour repérer rapidement d’éventuelles requêtes inattendues.
  • Ne laissez pas apparaître la valeur complète de la clé dans vos captures d’écran ou messages au support.

Transcription révisée

Cette transcription supprime toutes les valeurs de clés et actualise les formulations relatives à la sécurité tout en conservant la procédure montrée. Les libellés de Google Cloud, les exigences de facturation et les quotas ont pu changer depuis l’enregistrement.

00:04–00:33

Cette vidéo explique comment obtenir une clé API Google Maps et l’utiliser pour voler dans des lieux réels au sein de FPVSIM. Au moment de l’enregistrement, la fonction de tuiles cartographiques était expérimentale et nécessitait que chacun fournisse sa propre clé.

00:34–01:14

Connectez-vous à Google Cloud Console, effectuez la configuration initiale du compte et créez un premier projet. La création peut prendre un moment. Suivez ensuite les étapes de compte demandées par Google.

01:14–02:28

Après la configuration, la console permet d’accéder aux identifiants. Créez et copiez votre propre clé API, puis sécurisez-la avec des restrictions appropriées. La vidéo a brièvement montré une clé de démonstration, mais celle-ci devait être désactivée et ne doit pas être réutilisée.

02:47–03:11

Recherchez Map Tiles API dans la bibliothèque d’API et activez-la pour le projet. Si vous n’avez pas copié la clé plus tôt, vous pouvez la gérer depuis la page des identifiants.

03:11–04:18

L’enregistrement présente le quota disponible à l’époque et décrit la fonction comme expérimentale. Les tarifs et les limites relèvent de règles externes : consultez donc la version actuelle de Google Cloud Console plutôt que de vous fier aux anciens chiffres de la vidéo.

04:18–05:13

Ouvrez FPVSIM, choisissez « Quick Play », puis la scène Google Earth. Collez votre propre clé dans le champ de clé API et enregistrez-la. Les tuiles commencent à se charger. Si la vue initiale se trouve sous le sol, entrez de nouveau dans la scène.

05:13–08:55

La démonstration survole Waikiki, puis se dirige vers Diamond Head, à Hawaii. La vitesse de chargement des tuiles dépend de la connexion Internet, mais la scène permet d’explorer virtuellement la zone choisie sur de longues distances.

08:56–09:26

Utilisez une clé de votre propre projet, surveillez son utilisation et n’employez aucune clé exposée dans la vidéo. Le tutoriel se termine en invitant les spectateurs à poser leurs questions sur la configuration.

Questions fréquentes

Puis-je utiliser la clé API visible dans la vidéo originale ?

Non. C’était une clé de démonstration temporaire dont la désactivation était prévue. Créez une clé dans votre propre projet Google Cloud et appliquez-lui des restrictions.

La gratuité de Map Tiles API est-elle garantie ?

L’enregistrement de 2023 n’offre aucune garantie à ce sujet. Avant d’activer l’API, consultez dans votre propre console les tarifs, quotas, exigences de facturation et conditions actuels de Google Maps Platform.

Comment restreindre la clé ?

Limitez-la à Map Tiles API et appliquez la restriction d’application compatible la plus étroite, par exemple uniquement les origines ou applications nécessaires à votre utilisation de FPVSIM. Réservez le projet à cet usage.

Pourquoi les tuiles du monde sont-elles vides ou lentes à charger ?

Vérifiez que Map Tiles API est activée, que les restrictions de la clé correspondent à la requête, que la facturation et le quota sont actifs et que votre connexion permet le chargement des tuiles. Avec une connexion lente, les détails peuvent se compléter progressivement.

Que faire si je publie ma clé par accident ?

Révoquez immédiatement la clé exposée dans Google Cloud Console, créez-en une nouvelle, appliquez des restrictions et examinez l’utilisation à la recherche de requêtes inattendues.

Français