Vous êtes prêt !

Pour passer à l'étape de développement, accédez à notre documentation pour les développeurs.

Activer Google Maps Android API

Pour commencer, nous allons vous guider à travers la console Google Developers et effectuer deux ou trois petites choses :

  1. Créer ou choisir un projet
  2. Activer Google Maps Android API
  3. Créer les clés appropriées
Continuer

Obtenir une clé d'API

Pour utiliser Google Maps Android API, vous devez inscrire votre projet d'application dans la Google API Console et obtenir une clé d'API Google à ajouter à votre application. Remarque : Il existe différents types de restrictions pour les clés d'API. Vous avez besoin d'une clé d'API avec une restriction pour les applications Android (et non une clé restreinte à un navigateur).

Guide de démarrage rapide pour obtenir une clé

Étape 1. Obtenir une clé d'API depuis la Google API Console

Cliquez sur le bouton ci-dessous pour obtenir de l'aide tout au long du processus et activer Google Maps Android API automatiquement.

Obtenir une clé

Remarques :

  • Pour les clients Google Maps APIs Premium Plan : Lorsque le menu déroulant du projet est affiché, vous devez sélectionner le projet créé pour vous lors de l'achat deGoogle Maps APIs Premium Plan. Le nom du projet commence par Google Maps APIs for Business or Google Maps for Work or Google Maps.
  • Si vous souhaitez acheter une licence Premium Plan, veuillez contacter le service commercial.
  • À des fins de test, vous pouvez créer une clé d'API générique et sans restriction qui fonctionne sur n'importe quelle plateforme. Pour sécuriser votre clé avant de passer en production, vous devez restreindre la clé, tel que décrit ci-dessous.

Étape 2. Ajouter la clé d'API à votre application

Suivez les étapes ci-dessous pour intégrer la clé d'API au manifeste de votre application, dans le fichier AndroidManifest.xml.

  1. Dans AndroidManifest.xml, ajoutez l'élément suivant en tant qu'enfant de l'élément <application>, en l'insérant juste avant la balise fermante </application> :
        <meta-data
            android:name="com.google.android.geo.API_KEY"
            android:value="YOUR_API_KEY"/>
        

    Remplacez YOUR_API_KEY par votre clé d'API dans l'attribut value. Cet élément définit la clé com.google.android.geo.API_KEY sur la valeur de votre clé d'API.

  2. Enregistrez AndroidManifest.xml et recréez l'application.

Remarque : Comme indiqué ci-dessus, com.google.android.geo.API_KEY est le nom de métadonnées recommandé pour la clé d'API. Une clé portant ce nom peut être utilisée pour l'authentification auprès de diverses API basées sur Google Maps et s'exécutant sur la plateforme Android, notamment Google Maps Android API. Pour assurer la rétrocompatibilité, l'API prend également en charge le nom com.google.android.maps.v2.API_KEY. Cet ancien nom autorise l'authentification auprès des Android Maps API v2 uniquement. Une application ne peut spécifier qu'un seul des noms de métadonnées de clé d'API. Si les deux noms sont spécifiés, l'API renvoie une exception.

Et voilà. Si vous avez bien suivi les étapes ci-dessous, vous avez terminé. Si vous avez rencontré un problème, lisez les instructions détaillées ci-dessous concernant l'API standard et Premium Plan.

Guides détaillés qui expliquent comment obtenir une clé d'API

Guide détaillé pour les utilisateurs de Google Maps Android API standard

Si le fait de cliquer sur le bouton ne vous a pas emmené au bon endroit, vous pouvez suivre ces étapes alternatives pour obtenir une clé d'API :

  1. Allez à la Google API Console.
  2. Créez ou sélectionnez un projet.
  3. Cliquez sur Continue pour activer Google Maps Android API.
  4. Sur la page Credentials, obtenez une clé d'API.
    Remarque : Si vous possédez déjà une clé d'API avec des restrictions pour Android, vous pouvez l'utiliser.
  5. Dans la boîte de dialogue affichant la clé d'API, sélectionnez Restrict key afin de définir une restriction pour Android sur la clé d'API.
  6. Dans la section Restrictions, sélectionnez Android apps, puis saisissez l'empreinte SHA-1 de votre application et le nom du package. Par exemple :
    BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
    com.example.android.mapexample
  7. Vous trouverez plus d'informations sur les restrictions de clé d'API ci-dessous.
  8. Cliquez sur Save.

Votre nouvelle clé d'API restreinte à Android s'affiche dans la liste des clés d'API de votre projet. Une clé d'API est une chaîne de caractères semblable à ce qui suit :

AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

Guide détaillé pour les utilisateurs de la licence Google Maps APIs Premium Plan

Si le fait de cliquer sur le bouton ne vous a pas emmené au bon endroit, vous pouvez suivre ces étapes alternatives pour obtenir une clé d'API :

  1. Allez à la Google API Console.
  2. Dans le menu déroulant Project, sélectionnez le projet Google Maps Premium.*
  3. Cliquez sur Continue.
  4. Sur la page Credentials, obtenez une clé d'API.
  5. Dans la boîte de dialogue affichant la clé d'API, sélectionnez Restrict key afin de définir une restriction pour Android sur la clé d'API.
  6. Dans la section Restrictions, sélectionnez Android apps, puis saisissez l'empreinte SHA-1 de votre application et le nom du package. Par exemple :
    BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
    com.example.android.mapexample
    Vous trouverez plus d'informations sur les restrictions de clé d'API ci-dessous.
  7. Cliquez sur Save.

Votre nouvelle clé d'API restreinte à Android s'affiche dans la liste des clés d'API de votre projet. Une clé d'API est une chaîne de caractères semblable à ce qui suit :

AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

Informations supplémentaires sur la Google API Console

Vous pouvez également rechercher une clé existante dans la Google API Console.

Pour plus d'informations sur l'utilisation de la Google API Console, voir l'aide de la API Console.

Informations supplémentaires sur les restrictions de clé d'API

Les Google Maps API sont disponibles pour les applications Android ou iOS, les navigateurs Web et via les services Web HTTP. Sur toute plateforme, les API peuvent utiliser une clé d'API générique (sans restriction). Vous pouvez éventuellement ajouter une restriction. Pour les applications Android, vous restreignez la clé à l'empreinte SHA-1 de votre application et au nom de package. Les clés restreintes ne fonctionnent que sur les plateformes qui prennent en charge ce type de restriction.

Où obtenir l'empreinte SHA-1 de votre application

La restriction de clé d'API Android se base sur une version abrégée du certificat numérique de l'application, appelée empreinte SHA-1.

Obtenir les informations de certification d'Android Studio

Si vous suivez le guide de démarrage de Google Maps Android API, Android Studio crée un fichier google_maps_api.xml pratique avec les identifiants de votre application.

Choisissez l'une des méthodes suivantes pour obtenir votre clé d'API depuis Android Studio :

  • Méthode la plus simple et la plus rapide : Utilisez le lien fourni dans le fichier google_maps_api.xml qu'Android Studio a créé pour vous :
    1. Copiez le lien fourni dans le fichier google_maps_api.xml et collez-le dans votre navigateur. Ce lien vous dirige vers la Google API Console et fournit les informations requises pour la Google API Console via des paramètres d'URL, réduisant ainsi la saisie manuelle nécessaire de votre part.
    2. Suivez les instructions pour créer un nouveau projet sur la Google API Console ou sélectionnez un projet existant.
    3. Créez une clé d'API restreinte à Android pour votre projet.
    4. Copiez la clé d'API obtenue, retournez dans Android Studio et collez la clé d'API dans l'élément <string> du fichier google_maps_api.xml.
  • Méthode un peu moins rapide : Utilisez les informations d'identification fournies dans le fichier google_maps_api.xml qu'Android Studio a créé pour vous :
    1. Copiez les informations d'identification fournies dans le fichier google_maps_api.xml.
    2. Allez à la Google API Console dans votre navigateur.
    3. Utilisez les informations d'identification copiées pour ajouter votre application à une clé d'API existante ou pour en créer une nouvelle.

Obtenir vous-même les informations relatives au certificat

Si vous n'avez pas suivi le guide de démarrage lors de la création de votre application, vous devez obtenir vous-même l'empreinte SHA-1 pour votre certificat. Assurez-vous d'abord d'utiliser le bon certificat. Il existe deux types de certificats :

  • Un certificat de débogage : Les outils Android SDK génèrent ce certificat automatiquement lorsque vous créez une version de débogage. Utilisez ce certificat uniquement avec les applications que vous testez. N'essayez pas de publier une application signée avec un certificat de débogage. Le certificat de débogage est décrit plus en détail dans la section Signature en mode débogage de la documentation du développeur Android.
  • Certificat de production : Les outils Android SDK génèrent ce certificat lorsque vous créez une version de production. Vous pouvez également générer ce certificat à l'aide du programme keytool. Utilisez ce certificat lorsque vous êtes prêt à proposer une version publique de l'application.

Procédez comme suit pour afficher l'empreinte SHA-1 d'un certificat à l'aide du programme keytool et du paramètre -v. Pour plus d'informations sur le Keytool, voir la documentation Oracle.

Certificat de débogage

Afficher l'empreinte du certificat de débogage

  1. Recherchez le fichier keystore (magasin de clés) de débogage. Intitulé debug.keystore, il est généré la première fois que vous créez le projet. Par défaut, il est stocké dans le même répertoire que vos fichiers AVD (Android Virtual Device) :

    • macOS et Linux : ~/.android/
    • Windows Vista etWindows 7 : C:\Users\your_user_name\.android\
  2. Listez l'empreinte SHA-1 :

    • Pour Linux ou macOS, ouvrez une fenêtre sur le terminal et procédez comme suit :

      keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android
    • Pour Windows Vista et Windows 7, exécutez la commande suivante :

      keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android

Le résultat doit ressembler à ce qui suit :

Alias name: androiddebugkey
Creation date: Jan 01, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4aa9b300
Valid from: Mon Jan 01 08:04:04 UTC 2013 until: Mon Jan 01 18:04:04 PST 2033
Certificate fingerprints:
     MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6A:AC:F9
     SHA1: BB:0D:AC:74:D3:21:E1:43:07:71:9B:62:90:AF:A1:66:6E:44:5D:75
     Signature algorithm name: SHA1withRSA
     Version: 3
Certificat de production

Afficher l'empreinte du certificat de production

  1. Recherchez le fichier keystore du certificat de production. Il n'existe pas d'emplacement ou de nom par défaut pour le keystore de production. Si vous n'en spécifiez aucun lors du développement de votre application pour publication, le fichier .apk de la version n'est pas signé et vous devez le signer avant la publication. Pour le certificat de production, vous avez également besoin de l'alias du certificat et des mots de passe pour le keystore et le certificat. Vous pouvez afficher les alias de toutes les clés d'un keystore en saisissant :

    keytool -list -keystore your_keystore_name

    Remplacez le paramètre your_keystore_name par le chemin complet valide et le nom du keystore en ajoutant l'extension .keystore. Vous êtes alors invité à saisir le mot de passe du keystore. L'outil keytool affiche tous les alias du keystore.

  2. Saisissez la commande suivante sur un terminal ou dans une invite de commande :

    keytool -list -v -keystore your_keystore_name -alias your_alias_name

    Remplacez le paramètre your_keystore_name par le chemin complet valide et le nom du keystore en ajoutant l'extension .keystore. Remplacez le paramètre your_alias_name par l'alias que vous avez affecté au certificat lors de sa création.

Le résultat doit ressembler à ce qui suit :

Alias name: <alias_name>
Creation date: Feb 02, 2013
Entry type: PrivateKeyEntry
Certificate chain length: 1
Certificate[1]:
Owner: CN=Android Debug, O=Android, C=US
Issuer: CN=Android Debug, O=Android, C=US
Serial number: 4cc9b300
Valid from: Mon Feb 02 08:01:04 UTC 2013 until: Mon Feb 02 18:05:04 PST 2033
Certificate fingerprints:
    MD5:  AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6B:AC:F9
    SHA1: BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:90:AF:A1:66:6E:44:5D:75
    Signature algorithm name: SHA1withRSA
    Version: 3

La ligne commençant par SHA1 contient l'empreinte SHA-1 du certificat. L'empreinte est une séquence de 20 nombres hexadécimaux à deux chiffres séparés par un deux-points.

Pour plus d'informations sur les certificats numériques, voir le guide Android sur la signature des applications.

Envoyer des commentaires concernant…

Google Maps Android API
Google Maps Android API
Besoin d'aide ? Consultez notre page d'assistance.