Developpez.com - Java
X

Choisissez d'abord la catégorieensuite la rubrique :


Intégration Google Maps dans Android

Date de publication : 01 août 2009

Par Michel Dirix (http://michel-dirix.developpez.com/)
 


               Version PDF (Miroir)   Version hors-ligne (Miroir)

I. Obtention de la clé API
I-A. md5 checksum
I-B. Génération de la clé API et insertion dans le projet
II. Application graphique
II-A. Code
II-B. Explications
II-C. Résultat
III. Conclusion
IV. Liens


I. Obtention de la clé API


I-A. md5 checksum

Avant de pouvoir insérer une carte Google Maps dans l'interface graphique, il faut obtenir une clé API.

Tout d'abord, il faut créer un md5 checksum du debug certificate car chaque application doit être signée et la clé API est basée justement sur ce certificat.

Pour afficher ce md5, il faut d'abord savoir où se situe ce fichier de debug :

Si vous utilisez Eclipse, vous pouvez obtenir le chemin de la façon suivante :

Windows > Prefs > Android > Build


Une fois le chemin connu, il faut taper la commande suivante dans une console :
$ keytool -list -alias androiddebugkey -keystore <chemin_vers_le_fichier_debug>.keystore -storepass android -keypass android
Vous devriez obtenir un affichage similaire à celui-ci :

ftp://michel-dirix@ftp-developpez.com/tutoriels/android/integration-google-maps-android/images\screen2.png


I-B. Génération de la clé API et insertion dans le projet

Une fois cette première clé md5 checksum obtenue, vous pouvez générer la clé API à cette adresse :


un compte Google étant nécessaire.


Une fois la clé API obtenue, il faut l'ajouter dans le fichier String.xml de la façon suivante :
other
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="hello">Hello World, map</string>
<string name="app_name">map</string>
<string name="mapskey">056sXXXXxHceXYXYYhqy7R_BgNXXXXx6D0l_qNg</string>
</resources>

Il faut également modifier le fichier AndroidManifest.xml pour lui indiquer que l'API Google Maps est utile ainsi qu'ajouter les autorisations nécessaires pour utiliser internet et la localisation et ceci se fait de la manière suivante :
other
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
      package="com.developpez"
      android:versionCode="1"
      android:versionName="1.0">
	<application android:icon="@drawable/icon" android:label="@string/app_name">
    <uses-library android:name="com.google.android.maps" />
    
        <activity android:name=".Map"
                  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-sdk android:minSdkVersion="3" />
	<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"></uses-permission>
<uses-permission android:name="android.permission.INTERNET"></uses-permission>
</manifest>
Ce fichier manifest est sous Android 1.5 mais il est similaire sous Android 1.0.


II. Application graphique


II-A. Code

Une fois cette clé obtenue, nous pouvons enfin nous lancer dans le code.
other
package com.developpez;

import android.os.Bundle;
import android.widget.LinearLayout;

import com.google.android.maps.GeoPoint;
import com.google.android.maps.MapActivity;
import com.google.android.maps.MapController;
import com.google.android.maps.MapView;

public class Map extends MapActivity {
    private MapView mapView;
private MapController mc;
private GeoPoint location;

/** Called when the activity is first created. */
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        
        this.mapView =  new MapView(this,this.getResources().getString(R.string.mapskey));
        this.mapView.setClickable(true);
 this.mc = this.mapView.getController();
 double latitude = 50.606;
 double longitude = 3.15;
 this.location = new GeoPoint((int) (latitude * 1000000.0),
(int) (longitude * 1000000.0));
 this.mc.setCenter(this.location);
 this.mc.setZoom(17);
 this.mapView.setSatellite(true);
 this.mapView.invalidate();

 this.setContentView(this.mapView);
    }

public GeoPoint getLocation() {
return location;
}

public void setLocation(GeoPoint location) {
this.location = location;
this.mc.setCenter(this.location);
this.mapView.invalidate();
}

@Override
protected boolean isRouteDisplayed() {
return false;
}
}

II-B. Explications

this.mapView =  new MapView(this,this.getResources().getString(R.string.mapskey));

Cette ligne crée la carte en récupérant la clé API qui a été ajoutée dans le fichier String.xml modifié précédemment.
other
this.mc = this.mapView.getController();
double latitude = 50.606;
double longitude = 3.15;
this.location = new GeoPoint((int) (latitude * 1000000.0),(int) (longitude * 1000000.0));
this.mc.setCenter(this.location);

Cette partie se charge de récupérer le contrôleur chargé de positionner la carte à l'endroit indiqué par les coordonnées latitude et longitude. ( ces données sont multipliées par 1E6 car les données pour GeoPoint sont exprimées en microdegrès).
other
this.mc.setZoom(17);
this.mapView.setSatellite(true);
this.mapView.invalidate();

Change le zoom pour un zoom rapproché et passé la carte en vue satellitaire, on demande ensuite à redessiner la carte.


II-C. Résultat

ftp://michel-dirix@ftp-developpez.com/tutoriels/android/integration-google-maps-android/images\screen.png

III. Conclusion

Toute cette démarche nous a permis de développer notre première application intégrant une carte Google Maps. Cette carte s'avère très basique mais il est possible d'aller plus loin et de développer des applications à l'instar d'Apple avec son kit Nike+ Ipod.


IV. Liens

Démarche pour générer la clé :



Site pour générer la clé à partir du md5 :




               Version PDF (Miroir)   Version hors-ligne (Miroir)

Valid XHTML 1.0 TransitionalValid CSS!

Copyright © 2009 Michel Dirix. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents, images, etc. sans l'autorisation expresse de l'auteur. Sinon vous encourez selon la loi jusqu'à trois ans de prison et jusqu'à 300 000 € de dommages et intérêts.

Responsables bénévoles de la rubrique Java : Mickael Baron - Robin56 -