Guide de démarrage rapide de l'API Maps Embed

Insérez une carte interactive ou un panorama Street View sur votre page Web à l'aide d'une simple requête HTTP, sans JavaScript.

Coûts

Toutes les requêtes API Maps Embed sont sans frais et ont une utilisation illimitée. Toutefois, toutes les requêtes nécessitent toujours une clé API Google Cloud valide. Pour en savoir plus, consultez Utilisation et facturation.

Avant de commencer

Pour créer une carte intégrée sur votre page Web, suivez les étapes de configuration requises en cliquant sur les onglets suivants:

Étape 1

Console

  1. Dans la console Google Cloud, sur la page du sélecteur de projet, cliquez sur Créer un projet pour créer un projet Cloud.

    Accéder à la page du sélecteur de projet

  2. Assurez-vous que la facturation est activée pour votre projet Cloud. Vérifiez que la facturation est activée pour votre projet.

    Vous pouvez tester Google Cloud sans frais. La période d'essai expire au bout de 90 jours ou après que le compte a enregistré 300 $ de frais (selon la première échéance atteinte). Vous pouvez résilier à tout moment. Google Maps Platform propose un crédit mensuel récurrent de 200 $. Pour en savoir plus, consultez Crédits de compte de facturation et Facturation.

Cloud SDK

gcloud projects create "PROJECT"

En savoir plus sur le Google Cloud SDK, l'installation du Cloud SDK et les commandes suivantes :

Étape 2

Pour utiliser Google Maps Platform, vous devez activer les API ou les SDK que vous prévoyez d'utiliser avec votre projet.

Console

Activer l'API Maps Embed

SDK Cloud

gcloud services enable \
    --project "PROJECT" \
    "maps-embed-backend.googleapis.com"

En savoir plus sur le Google Cloud SDK, l'installation du Cloud SDK et les commandes suivantes :

Étape 3

Cette étape concerne uniquement le processus de création de la clé API. Si vous utilisez votre clé API en production, nous vous recommandons vivement de la restreindre. Vous trouverez plus d'informations sur la page Utiliser des clés API spécifique au produit.

Une clé API est un identifiant unique qui permet d'authentifier les requêtes associées à votre projet à des fins d'utilisation et de facturation. Vous devez associer au moins une clé API à votre projet.

Pour créer une clé API :

Console

  1. Accédez à la page Google Maps Platform > Identifiants.

    Accéder à la page "Identifiants"

  2. Sur la page Identifiants, cliquez sur Créer des identifiants > Clé API.
    La boîte de dialogue Clé API créée affiche la clé API que vous venez de créer.
  3. Cliquez sur Fermer.
    La nouvelle clé API figure sur la page Identifiants sous Clés API.
    (N'oubliez pas de restreindre la clé API avant de l'utiliser en production.)

Cloud SDK

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

En savoir plus sur le Google Cloud SDK, l'installation du Cloud SDK et les commandes suivantes :

Générer un iFrame

Parcourez les options suivantes, puis ajoutez un emplacement et une clé API pour générer une iFrame pour votre page Web. Pour en savoir plus sur les paramètres et les options supplémentaires, consultez Intégrer une carte.

Tester votre iFrame

Pour afficher votre iFrame dans une fenêtre de navigateur HTML:

  1. Ouvrez votre éditeur de texte par défaut. Des éditeurs de texte tels que TextEdit ou Microsoft Windows Notepad doivent être installés par défaut sur votre appareil.
  2. Créez un fichier HTML et nommez-le index.html.

  3. Ajoutez le code suivant avec l'iframe que vous avez générée ci-dessus:

    <html>
  <!-- Replace this code comment with your iframe. -->
</html>

  4. Enregistrez votre fichier HTML index.html.

  5. Chargez le fichier HTML dans un navigateur Web en le faisant glisser depuis le Bureau vers votre navigateur. Vous pouvez également double-cliquer dessus dans la plupart des systèmes d'exploitation.

Félicitations ! Vous venez de configurer et de créer une carte à l'aide de l'API Maps Embed.

Nettoyer

Vous pouvez supprimer votre projet Google Cloud. La facturation de toutes les ressources qu'il utilise sera ainsi interrompue.

  1. Dans la console Google Cloud, accédez à la page Gérer les ressources:

    Accéder à la page Gérer les ressources

  2. Si le projet que vous envisagez de supprimer est associé à une organisation, sélectionnez et développez la liste des organisations en haut de la page.
  3. Dans la liste des projets, sélectionnez celui que vous souhaitez supprimer, puis cliquez sur Supprimer.
  4. Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez sur Arrêter pour le supprimer.

Étapes suivantes