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

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Placez 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 disponibles sans frais et avec une utilisation illimitée. Cependant, 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 à votre page Web, effectuez 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érifier si la facturation est activée sur un 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.

SDK Cloud

gcloud projects create "PROJECT"

En savoir plus sur le SDK Google Cloud, l'installation du SDK Cloud 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 SDK Google Cloud, l'installation du SDK Cloud 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.)

SDK Cloud

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

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

Générer un iFrame

Cliquez sur les options suivantes, puis ajoutez un emplacement et une clé API afin de générer un iFrame pour votre page Web. Pour découvrir d'autres paramètres et options, 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 généré 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 de l'écran de votre ordinateur vers le navigateur. Vous pouvez également double-cliquer sur le fichier depuis 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 pour arrêter la facturation de toutes les ressources qu'il utilise.

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

    Accéder à la page Gérer les ressources

  2. Si le projet que vous prévoyez 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 supprimer le projet.

Étapes suivantes