Configuration d'applications Android pour utiliser Google Maps

Remonter à Tutoriel mobile : Utilisation d'un composant Carte pour travailler avec des cartes (iOS et Android)

Cette rubrique explique comment configurer vos applications Android pour utiliser le composant TMapView et l'API Google Maps Android.

Il développe les sujets suivants :

• Obtention de la clé API Android
• Configuration d'options de projet spécifiques

Obtention de la clé API Android

Pour accéder aux serveurs Google Maps avec la clé de l'API Android Google Maps, vous devez d'abord ajouter une clé API Android à votre application. Cette section présente les étapes élémentaires pour obtenir cette clé :

1. Récupérez les informations concernant le certificat de votre application.
2. Recensez un projet dans la console Google API et activez l'API Android Google Maps pour ce projet.
3. Configurez la clé API Android.

Important Cette section décrit comment obtenir la clé Android Google Maps en utilisant Google API Console. L'interface utilisateur de cette console, y compris les noms des contrôles, sont susceptibles de connaître des modifications sans préavis. Pour plus d'informations sur la version la plus récente de Google API Console, voir la documentation Google appropriée.

Récupération de votre certificat d'application

La clé d'API Maps est basée sur une forme courte du certificat numérique de votre application, appelée empreinte SHA-1. L'empreinte est une chaîne de texte unique générée à partir de l'algorithme de hachage SHA-1 couramment utilisé. Il existe deux types de certificats : le certificat debug (débogage) et le certificat release (publication).

Remarque : Cette section explique comment récupérer le certificat debug. Pour des informations sur la récupération d'un certificat release, voir Get an Android certificate and the Google Maps API key (EN).

Pour afficher l'empreinte du certificat debug

1. Localisez le fichier debug.keystore approprié. RAD Studio utilise le fichier debug.keystore situé dans :
   %Users%\<nom d'utilisateur>\AppData\Roaming\Embarcadero\BDS\<numéro de version>\, par exemple :
   C:\Users\JohnDoe\AppData\Roaming\Embarcadero\BDS\22.0\debug.keystore

   Conseil : Si vous ne trouvez pas le fichier debug.keystore à l'emplacement mentionné ci-dessus, exécutez votre application sur la plate-forme cible Android, et RAD Studio créera automatiquement ce fichier.

   
   
2. Localisez le fichier keytool.exe. L'outil keytool est disponible dans le <dossier d'installation de Java>\Bin, par exemple :
   C:\Programmes\Java\jdk1.7.0_71\bin\.
   
3. Accédez au dossier où le fichier debug.keystore est situé et exécutez :
   keytool -list -v -keystore debug.keystore -alias androiddebugkey -storepass android -keypass android
   

   Conseil : Vous devez ajouter le chemin d'accès complet à keytool ; si le fichier keytool.exe est situé dans l'exemple mentionné ci-dessus, vous pouvez utiliser ce qui suit :
   

   "C:\Program Files\Java\jdk1.7.0_71\bin\keytool" -list -v -keystore debug.keystore -alias androiddebugkey -storepass android -keypass android

   
   
4. L'outil keytool affiche un résultat similaire à ce qui suit : Alias name: androiddebugkey Creation date: Jan 24, 2015 Entry type: PrivateKeyEntry Certificate chain length: 1 Certificate[1]: Owner: CN=Unnamed, OU=Mobile Organization, O=My Company, L=San Francisco, ST=California, C=US Issuer: CN=Unnamed, OU=Mobile Organization, O=My Company, L=San Francisco, ST=California, C=US Serial number: 1af9d77f Valid from: Sat Jan 24 23:12:12 GST 2015 until: Sat Jan 11 23:12:12 GST 2042 until: Certificate fingerprints: MD5: 20:E1:7D:12:4F:83:2A:37:FB:F5:43:3B:CC:27:88:4B SHA1: 0B:4D:1E:83:2F:91:3A:BD:92:EB:87:62:6D:34:66:9D:6A:51:3B:ED SHA256: 91:75:AC:BE:C9:74:6F:67:3E:9A:E4:35:04:D4:05:E0:8F:A4:54:30:41:4A:EB:0A:61:E0:D1:33:7C:D8:0F:82 Signature algorithm name: SHA256withRSA Version: 3 La ligne qui commence par SHA1 contient l'empreinte SHA-1 du certificat. L'empreinte est la séquence de 20 nombres hexadécimaux à deux chiffres séparés par des caractères deux points.

Création d'un projet API dans la console Google API

Important : Avant de poursuivre, assurez-vous que vous disposez d'un compte Google (EN).

1. Allez à la page Google API Console.
2. Dans la liste des projets, sélectionnez Créer un projet.
3. Entrez un nom et spécifiez un ID de projet ou acceptez la valeur par défaut.
4. Cliquez sur Créer.

Configuration d'une clé API Android

Vous pouvez à présent configurer une clé API Android. Il est possible de recenser plus d'une clé par projet.

Pour configurer une clé API Android

1. Naviguez jusqu'à votre projet dans la console Google API.
2. Accédez à la page Gestionnaire d'API, et sur la gauche, choisissez Identifiants.
3. Cliquez sur Créer des identifiants puis sélectionnez Clé API.
4. Dans la page Créer une nouvelle clé, cliquez sur Applications Android.
5. Dans la boîte de dialogue obtenue, cliquez sur le bouton + Ajouter nom du package et empreinte, puis entrez les informations voulues dans Nom du package et Empreinte du certificat SHA-1.

   Important : Pour obtenir une clé d'API Android valide, assurez-vous que vous utilisez le nom exact du package de l'application. Ce nom identifie de manière unique votre application. La clé package du champ Informations de version Android contient le nom de package (voir la copie d'écran sous la procédure "Pour définir la valeur de la clé apiKey" un peu plus loin dans ce document).

6. Cliquez sur Créer.
   La console Google APIs affiche la clé API suivie d'une clé API de quarante caractères, comme par exemple : API key: AIzaSyCMuJ2w8_gQEedvqUg-9lxWXFg7feAl9PQ

Configuration d'options de projet spécifiques

Pour que votre application Android accède à Google Maps, assurez-vous que vous avez configuré les options et permissions de projet suivantes :

• Activez les autorisations d'utilisation appropriées.
• Activez l'option relative aux droits Service cartographique.
• Définissez la valeur de la clé apiKey dans les informations sur la version Android.

Important : Avant de poursuivre, dans le Gestionnaire de projets, définissez la plate-forme cible sur Android :

Pour contrôler la liste des permissions configurées

1. Dans l'EDI de RAD Studio, ouvrez Projet > Options > Permissions d'utilisation.
2. Vérifiez que vous avez activé les autorisations suivantes :
   • Accéder à un emplacement approximatif
   • Accéder à un emplacement précis
   • Accéder à l'état du réseau

   

Pour vérifier la liste des droits

1. Dans l'EDI de RAD Studio, ouvrez Projet > Options > Liste des droits.
2. Assurez-vous que l'option Service cartographique est activée :
   

Pour définir la valeur de la clé apiKey

1. Dans l'EDI de RAD Studio, ouvrez Projet > Options > Informations de version.
2. Définissez la clé apiKey sur la valeur de la clé d'API Android que vous avez demandée pour votre application (voir l'étape 6 dans la section Configuration d'une clé d'API plus haut dans ce document).
3. Cliquez sur OK.
   

Important : Pour que les changements de vos options de projet prennent effet, appuyez sur Maj + F9 afin de reconstruire votre projet.

Voir aussi

• TMapView
• Tutoriel mobile : Utilisation d'un composant Carte pour travailler avec des cartes (iOS et Android)

Exemples de code

• Exemple Tabbed Map
• Exemple Map