Accueil

Afficher une carte dans une application Android

Ecrit par loic le 20/11/2009.
| |



Introduction

Nous allons ici apprendre à insérer une carte Google Maps dans une application Android (OS Google pour les téléphones portables).
Ce tutoriel précise les étapes indispensables de configuration de votre atelier de développement pour y parvenir.

Créer une cible typée cartographie pour l'émulateur

Allez dans le répertoire tools de votre sdk 1.5, et tapez la commande : 
android list targets

Vous devriez avoir un résultat semblable à ceci :

Available Android targets:
id:1
    Name: Android 1.1
    Type: platform
    API level: 2
    Skins: HVGA (default), HVGA-L, HVGA-P, QVGA-L, QVGA-P
id:2
    Name: Android 1.5
    Type: platform
    API level: 3
    Skins: HVGA (default), HVGA-L, HVGA-P, QVGA-L, QVGA-P
id:3
    Name: Google APIs
    Type: add-on
    Vendor: Google Inc.
    Description: Android + Google APIs
    Based on Android 1.5 (API level 3)
    Libraries:
    * com.google.android.maps (maps.jar)
        API for Google Maps
    Skins: HVGA (default), HVGA-L, QVGA-P, HVGA-P, QVGA-L

Vous pouvez alors créer un nouvel AVD (Android Virtual Device)

android create avd -n <name> -t <targetID>
 
par exemple :
 
android create avd -n avd3 -t 3

Ensuite vous pouvez vérifier la création de votre AVD ciblé pour la cartographie en tapant

android list avds
 
résultat :
 
Available Android Virtual Devices:
    Name: avd1
    Path: C:\Users\Loic\.android\avd\avd11.avd
  Target: Android 1.1 (API level 2)
    Skin: HVGA
---------
    Name: avd2
    Path: C:\Users\Loic\.android\avd\avd12.avd
  Target: Android 1.5 (API level 3)
    Skin: HVGA
---------
    Name: avd3
    Path: C:\Users\Loic\.android\avd\avd13.avd
  Target: Google APIs (Google Inc.)
          Based on Android 1.5 (API level 3)
    Skin: HVGA

Votre émulateur pouvant afficher des cartes est maintenant créé.

Créer l'application dans Eclipse

Nouveau projet avec cible spécifique

Dans Eclipse, créez un nouveau projet Android, et veillez bien à sélectionner Google APIs comme cible :

Adaptation du manifest

La librairie Google APIs ne fait pas parti du socle standard Android, il faut spécifier cette utilisation dans le manifest AndroidManifest.xml.
Ajoutez sous la balise <application>

<uses-library android:name="com.google.android.maps" />

Les tuiles Google Maps sont téléchargées dynamiquement via Internet, il faut donc donner l'autorisation d'accés à Internet à votre d'application.
Ajoutez sous la balise <manifest>

<uses-permission android:name="android.permission.INTERNET" />

Quel Layout pour une carte

Il faut maintenant declarer une MapView dans vote Layout principal.
Dans /res/layout/main.xml , insérer ce code qui déclare qu'une carte cliquable va occuper toute la fenêtre.

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/mainlayout"
    android:orientation="vertical"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent" >
 
    <com.google.android.maps.MapView
        android:id="@+id/mapview"
        android:layout_width="fill_parent"
        android:layout_height="fill_parent"
        android:clickable="true"
        android:apiKey="Your Maps API Key"
    />
 
</RelativeLayout>

Il manque donc ici votre Maps API Key qui prouve que vous êtes enregistré auprés de Google pour utiliser son service. Voyons maintenant comment la récupérer.

Obtenir une Maps API Key

Il faut d'abord obtenir votre empreinte du certificat (MD5) pour votre atelier de développement.
Pour cela, il suffit de taper la commande suivante (keytool est disponible dans votre JDK) :

keytool -list -alias androiddebugkey -keystore <path_to_debug_keystore>\debug.keystore -storepass android -keypass android

Le fichier debug.keystore est stocké dans un répertoire dépendant de votre OS :

Windows Vista: C:\Users\<user>\.android\debug.keystore 
Windows XP: C:\Documents and Settings\<user>\.android\debug.keystore 
OS X and Linux: ~/.android/debug.keystore

Vous devriez obtenir ceci :

androiddebugkey, 14 mai 2009, PrivateKeyEntry,
Empreinte du certificat (MD5) : 32:39:0C:F0:2D:48:32:A5:7C:3D:6A:xx:xx:xx:xx:xx

Muni de cette empreinte, allez sur le site http://code.google.com/android/maps-api-signup.html .
Si vous n'avez pas de compte Google , c'est le moment d'en créer un.
Acceptez les conditions et entrez votre empreinte. Vous obtiendrez votre clé Maps API, qu'il suffit de mettre dans votre fichier de Layout.

Un peu de java, enfin

Voici le code le plus simple pour afficher une carte dans votre application.

package com.test;
 
import com.google.android.maps.MapActivity;
import android.os.Bundle;
 
public class MainActivity extends MapActivity {
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
    }
 
    protected boolean isRouteDisplayed() {
        return false;
    }
 
}

Votre activité est une MapActivity et non une Activity simple. Il faut donc implémenter la méthode isRouteDispayed().
Lancez l'émulateur, vous devriez voir ceci :

Remarques

Liens utiles :
Eclipse : http://www.eclipse.org/downloads/
Android Developers : http://developer.android.com/intl/fr/index.html
Android SDK : http://developer.android.com/intl/fr/sdk/index.html

Conclusion

Ce premier tutoriel à propos d'Android peut sembler un peu technique, mais il s'agit surtout de bien configurer son atelier de développement. Pour insérer des cartes Google Maps dans Android, vous ne pouvez pas simplement développer des pages html/javascript avec l'API Google Maps, il faut penser 'application' et non 'client léger', même si, je vous l'accorde les clients légers ne sont plus légers que par leur nom. Ici vous allez pouvoir profiter de toute l'API Android qui peut récupérer beaucoup d'informations intéressantes (localisation GPS ,accéleromètre, ...). D'autres tutoriels viendront pour éclairer ces points.



Auteur : Loïc - loic.goblet [ at ] gmail.com



Retour en haut

Bonjour, Alors voilà, dans le

Par Vinss (non vérifié), le dim, 27/11/2011 - 12:48pm.

Bonjour,
Alors voilà, dans le cadre de mon projet de DUT je développe un application sous Android devant afficher une carte.
Le soucis, c'est qu'il m'est impossible d'obtenir ma clef.
J'ai bien le MD5 mais quand je le rentre scrupulesement sur le site de Google, il me dit:
"L'empreinte spécifiée n'est pas valide. Appuyez sur le bouton Précédent de votre navigateur et spécifiez une empreinte valide pour le certificat. "

J'ai entré les lettres en majuscule et les ":" entre chaque octet.

Merci par avance.

Bonjour, J'ai résolu mon

Par Vinss (non vérifié), le jeu, 01/12/2011 - 7:27pm.

Bonjour,
J'ai résolu mon problème. En fait le keytool me donnait un clef en SHA1 et non MD5.
pour obtenir le MD5, il faut utiliser la commande keytool -v -list -keystore c:\Users\Vinss\.android\debug.keystore

Par contre, mon application ne se lance pas... :(

Bonjour, J'ai le problème

Par Mus (non vérifié), le lun, 16/05/2011 - 11:55am.

Bonjour,

J'ai le problème suivant : l'appli marche parfaitement sur eclipse, sauf qu'une fois portée sur mon téléphone (*.apk) la carte ne s'affiche pas et à la place jai des carreaux avec le sigle de google en bas a gauche !
merci pour votre aide

Bonjour, en phase de

Par fabien, le lun, 16/05/2011 - 2:54pm.

Bonjour,
en phase de développement il est conseillé de 'brancher' directement son téléphone à eclipse et de lancer les applications sur le téléphone directement sans faire des .apk .
De ce fait vous pourrez récupérer les logs et voir ce qui cloche.

Fabien

Jai l'erreur suivante

Par Mus (non vérifié), le dim, 29/05/2011 - 1:56am.

Jai l'erreur suivante :
MapActivity Couldn't getconnection factory client.

Euh bonjour, je pense qu'il

Par fabien, le lun, 30/05/2011 - 10:58am.

Euh bonjour,
je pense qu'il s'agit d'un problème de clé.
Fabien