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

Placez une carte interactive ou un panorama Street View sur votre page Web à l'aide d'une simple requête HTTP (aucun JavaScript n'est requis).

Coûts

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

Avant de commencer

Pour créer une carte intégrée à votre page Web, suivez la procédure de configuration requise 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.

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

Cloud SDK

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

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 connaître les autres paramètres et options, consultez Intégrer une carte à un site Web.

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é 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. Sur la plupart des systèmes d'exploitation, vous pouvez également double-cliquer dessus.

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 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 le projet 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