Android: Google map et Géolocalisation

Transcription

1 Matiaz OUINE Juin 2012 Benoit RAYMOND Ensimag 2A Projet de spécialité David DUMENIL Florian GUFFON Projet de spécialité: Développement d une application Android utilisant la géolocalisation Tutoriel : Android: Google map et Géolocalisation 1

2 1 Pré-requis Insertion d une carte Google Maps Obtenir une clé API Obtention du MD Génération de la clé API Travail collaboratif Implémentation Mise en place Code XML Code Java Géolocalisation Recuperer la position : Les Provider Marquer la carte : les Overlay

3 1 Pré-requis Avant de suivre ce tutoriel, vous devez avoir lu des tutoriels d introduction à la programmation Android ainsi que l installation de votre environnement de travail sur Eclipse. Il est nécessaire d avoir installé le plugin ADT (Android development Tools) de Eclipse. 2 Insertion d une carte Google Maps Nous présentons ici la démarche à suivre afin d insérer une carte Google Maps dans votre application Android. Nous allons nous appuyer sur l API Google correspondante disponible ici : Obtenir une clé API L utilisation d une carte Google Maps impose la génération d une clé propre à votre application, nous détaillons ici les étapes afin de l obtenir Obtention du MD5 La première étape consiste à obtenir votre MD5 checksum nécessaire à la génération de votre clé, il est généré à partir du «debug certificate» associé à votre application. Nous avons donc besoins du fichier debug.keystore, il y a plusieurs solutions pour localiser ce fichier : Windows 7: C:\Users\xxxx\.android\debug.keystore Linux: ~/.android/debug.keystore Si vous utilisez Eclipse, vous pouvez le localiser de la manière suivante : «Windows -> Preferences -> Android -> Build» 3

4 Démarrer ensuite une console et exécuter la commande suivante : keytool -list -alias androiddebugkey keystore <chemin_vers_le_fichier_debug>.keystore -storepass android -keypass android (Si keytool n est pas reconnu, son exécutable se trouve dans les binaires Java) Vous obtenez en sortie votre MD5 checksum Génération de la clé API Rendez vous maintenant ici : Remplissez les champs demandés, ainsi que votre MD5. Vous obtenez votre clé API, stocker la dans un fichier, elle nous servira ensuite. 2.2 Travail collaboratif Comme dit précédemment, la clé API générée est propre à votre application, dans le cadre d un développement en équipe, la solution pour éviter que chacun ne génère sa propre clé API correspondant à sa version de l application est de partager le fichier debug.keystore. Chaque développer doit utiliser la même version. Si vous développez avec Eclipse, il est possible de partager le debug.keystore à l aide de votre gestionnaire de version et de préciser qu il faut utiliser ce fichier. Pour cela: «Window -> Preferences -> Android -> Build» puis donner le chemin du fichier à utiliser. 4

5 2.3 Implémentation Commençons maintenant l implémentation, elle se déroule en trois étapes : La mise en place du projet (Manifest et configuration de Eclipse) Le code XML Le code Java Mise en place Installation de l API Google et création de L AVD Si vous avez installé le plugin ADT (Android Development Tools) de Eclipse vous devriez voir ces deux icones : Le premier permet d installer différentes version de SDK et le second de créer des AVD (Android Virtual Device), un AVD permet de simuler l exécution de l application sur une plateforme Android. Cliquez sur celui de gauche, afin de lancer notre application, nous devons installer google APIs, dans cet exemple, nous utiliserons la version d Android, installer donc au minimum le «SDK Platform» ainsi que «Google APIs» pour cette version : 5

6 Nous allons maintenant créer l AVD qui nous permettra de lancer notre application sur notre ordinateur (Sur une platforme Android virtuelle), pour cela, cliqué maintenant sur le bouton de droite : Vous pouvez à présent créer une nouvelle AVD, comme ci-dessous : 6

7 Création du projet Notre environnement de travail est configuré, créons maintenant nouveau projet Android, nous l appellerons ici androidgooglemap : 7

8 Il vous est ensuite demandé de choisir un SDK pour le projet (celui si est par la suite modifiable), nous choisissons ici l API Google que nous venons de télécharger. Nous créons une activité nommé AndroidGoogleMapActivity dans le package googlemap.tutoriel : 8

9 Notre projet est créé, passons maintenant à l implémentation de l application. Pour plus de détail sur la structure d une application android, veuillez lire une introduction à la programmation android Mise en place du manifest Dans le fichier AndroidManifest.xml, ajoutez les lignes suivantes: - Cette première entre les balises <application> </application> qui permet de préciser que nous allons utiliser la librairie permettant l usage de carte Google Maps. <uses-library android:name="com.google.android.maps" /> - Cette seconde, entre les balises <manifest> </manifest> donnant à notre application l autorisation d utiliser l accès internet de la plateforme : <uses-permission android:name="android.permission.internet" /> Ce qui devrait vous donner : <?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android=" package="googlemap.tutoriel" android:versioncode="1" android:versionname="1.0" > <uses-sdk android:minsdkversion="10" /> <application android:icon="@drawable/ic_launcher" android:label="@string/app_name" > <uses-library android:name="com.google.android.maps" /> <activity android:name=".androidgooglemapactivity" android:label="@string/app_name" > <intent-filter> <action android:name="android.intent.action.main" /> <category android:name="android.intent.category.launcher" /> </intent-filter> </activity> </application> <uses-permission android:name="android.permission.internet" /> </manifest> Code XML Modifions maintenant le fichier main.xml (res/layout/main.xml) qui contient les vues qui seront affichées par notre activité principale. Ajouter dans de LinearLayout (entre les balise <LinearLayout> </LinearLayout>) le code suivant : 9

10 <com.google.android.maps.mapview android:layout_width="fill_parent" android:layout_height="fill_parent" android:enabled="true" android:clickable="true" android:apikey="votre_api_key " /> Vous devez mettre votre API key au champ android:apikey. Ce code nous permet d ajouter une carte GoogleMaps à notre activité Code Java Modifier le fichier AndroidGoogleMapActivity.java (qui correspond à l activité qui sera lancé en premier lors du démarrage de l application) afin qu il corresponde au code si dessous. package googlemap.tutoriel; import com.google.android.maps.mapactivity; import android.app.activity; import android.os.bundle; public class AndroidGoogleMapActivity extends MapActivity { /** Called when the activity is first created. public void oncreate(bundle savedinstancestate) { super.oncreate(savedinstancestate); protected boolean isroutedisplayed() { // TODO Auto-generated method stub return false; Détaillons un peu ce code : - la classe étend maintenant MapActivity, qui nous permet de manipuler une carte GoogleMaps. - La méthode isroutedisplayed() est obligatoire mais n a pas d importance dans notre cas. - La ligne setcontentview(r.layout.main); permet de définir le layout qui sera afficher. Ce layout contient les vues de l activité (Ici, la carte) Démarrage de l application Pour lancer votre application dans une AVD (Android Virtual Device), effectué l opération suivante : «click droit sur le projet -> run as -> android application» Vous devez ensuite sélectionner l AVD dans laquelle vous voulez démarrer votre application : 10

11 Vous voyez apparaitre ensuite cet écran, l AVD est en cours de démarrage, cela peu prendre plusieurs minutes 11

12 Une fois démarré, votre application est directement lancée, voici le résultat de notre application : 3 Géolocalisation 3.1 Recupérer la position : les Providers Avant de récupérer la position de l utilisateur, on va ajouter des champs à notre classe AndroidGoogleMapActivity afin de pouvoir manipuler la carte. Le champ mapview va permettre de conserver la vue associée à la carte. private MapView mapview = null; Le champ mc va permettre de conserver le contrôleur associé à la vue. private MapController mc = null; Ces champs sont initalisés dans la méthode oncreate ainsi : mapview = (MapView) this.findviewbyid(r.id.mapview); mc = mapview.getcontroller(); Pour pouvoir récupérer la position d un utilisateur, on dispose d un listener sous la forme de l interface LocationListener. Reprenez la classe AndroidGoogleMapActivity et faites lui implémenter l interface LocationListener. Il y a alors quatre méthodes à implémenter : 12

13 @Override public void onlocationchanged(location location) public void onproviderdisabled(string provider) public void onproviderenabled(string provider) public void onstatuschanged(string provider, int status, Bundle extras) { La méthode onlocationchanged est appelée lors d une modification de localisation de l utilisateur. En ajoutant le code suivant dans la méthode, la carte sera centrée sur notre position à chaque changement public void onlocationchanged(location location) { GeoPoint p = new GeoPoint((int) (location.getlatitude() * 1E6), (int) (location.getlongitude() * 1E6)); // on centre la carte par rapport à notre position mc.setcenter(p); Il faut ensuite indiquer à la carte quel fournisseur de localisation (provider), elle va utiliser. On crée un nouveau champ à la classe qui va récupérer le service associé à la localisation dans le téléphone : private LocationManager lm = null; On l initialise dans la méthode oncreate() : lm = (LocationManager) this.getsystemservice(location_service); À la fin de la méthode oncreate(), on peut alors ajouter : // localisation par le gps lm.requestlocationupdates(locationmanager.gps_provider, 1, 5, this); // localisation par le réseau lm.requestlocationupdates(locationmanager.network_provider, 1, 5, this); Le premier paramètre indique le type de provider, le second le temps en millisecondes à attendre entre deux localisations, le troisième la précision en mètres au-delà de laquelle on considère qu il y a eu modification de la localisation et le dernier paramètre correspond au LocationListener qui recevra les mises à jour. 13

14 Il faut ajouter dans le AndroidManifest, avant la balise <application> les permissions nécessaires en fonction du provider : Pour le réseau (NETWORK_PROVIDER) : <uses-permission android:name="android.permission.internet" /> Pour le GPS (GPS_PROVIDER) : <uses-permission android:name="android.permission.access_fine_location" /> Lancer l application pour voir fonctionner la géolocalisation. Si vous utilisez un émulateur sous Eclipse, vous pouvez lui envoyer une nouvelle position en affichant la fenêtre Emulator Control. 3.2 Marquer la carte : les Overlay Dans cette partie nous allons voir comment ajouter des marqueurs sur la carte. Dans un premier temps créez une classe BasicItemizedOverlay qui hérite de la classe ItemizedOverlay avec le champ ci-dessous qui contiendra les marqueurs à afficher. private ArrayList<OverlayItem> moverlays = new ArrayList<OverlayItem>(); 14

15 Il faut ensuite écrire les méthodes protected OverlayItem createitem(int i) { return public int size() { return moverlays.size(); public synchronized void addoverlay(overlayitem overlay) { moverlays.add(overlay); populate(); public synchronized void clear() { moverlays.clear(); populate(); On ajoute ensuite un attribut mcontext de type Context à la classe pour conserver le contexte parent et on ajoute deux constructeurs. public BasicItemizedOverlay(Drawable defaultmarker, Activity context) { // on centre l'image super(boundcenterbottom(defaultmarker)); mcontext = context; populate(); public BasicItemizedOverlay(Drawable defaultmarker) { // on centre l'image super(boundcenterbottom(defaultmarker)); populate(); La méthode populate permet d initialiser les marqueurs en appelant la méthode createitem. Il est nécessaire de l appeler dans le constructeur si la liste moverlays est vide et à chaque ajout d un nouvel élément dans la liste pour garder une correspondance entre cette liste et les marqueurs créés. Enfin la méthode ontap peut être définie pour gérer le clic sur le marqueur. 15

16 @Override protected boolean ontap(int index) { OverlayItem item = moverlays.get(index); AlertDialog.Builder dialog = new AlertDialog.Builder(mContext); dialog.settitle(item.gettitle()); dialog.setmessage(item.getsnippet()); dialog.show(); return true; Il faut maintenant l utiliser dans la classe AndroidGoogleMapActivity. Ajouter le champ itemizedoverlay de type BasicItemizedOverlay dans cette classe. À la fin de la méthode oncreate, ajouter ces lignes pour l initialiser : // image utilisée pour le marqueur, ici ic_launcher Drawable drawable = this.getresources().getdrawable(r.drawable.ic_launcher); // initialisation itemizedoverlay = new BasicItemizedOverlay(drawable, this); // ajout à la carte mapview.getoverlays().add(itemizedoverlay); Enfin, à la fin de méthode onlocationchanged ajoutez // creation du marqueur OverlayItem overlayitem = new OverlayItem(p,"Hello","Vous êtes ici"); // on supprimme l ancien marqueur itemizedoverlay.clear() ; // ajout du nouveau itemizedoverlay.addoverlay(overlayitem); Lancez l application et vous verrez un marqueur apparaître à votre position. 16