L'API Google de Géolocalisation pour Android
L'API Google de Géolocalisation pour Android
Software Development - Google Maps and Android Geolocation API · notes
Fiche de révisionRésumé
Rédigée à partir de ce document, puis vérifiée avant publication.
L'API Google de géolocalisation pour Android permet aux développeurs d'intégrer des fonctionnalités de localisation dans leurs applications. Ce guide vous fournira des étapes détaillées sur la configuration de l'API, l'utilisation de Google Maps, et des exemples pratiques pour afficher des cartes et des marqueurs. Vous apprendrez également à obtenir une clé API et à configurer votre projet Android pour utiliser ces services.
La géolocalisation repose sur le système GPS (Global Positioning System), qui utilise au moins 24 satellites en orbite autour de la Terre. Ces satellites diffusent leur position et l'heure, permettant à un récepteur équipé d'une horloge de calculer sa position avec une précision variant de 15 à 100 mètres.
En plus du GPS, Android utilise le réseau de localisation basé sur les réseaux téléphoniques cellulaires et le Wi-Fi, ce qui est conseillé pour son efficacité énergétique, sa rapidité et sa capacité à fonctionner à l'intérieur comme à l'extérieur.
Android permet d'accéder aux Google Maps via une API dédiée. L'API Google Maps Android v2, intégrée dans l'Android SDK Manager, offre des fonctionnalités avancées pour manipuler des cartes. Pour commencer, vous devez être enregistré auprès de Google Maps et obtenir une clé API v2.
Les étapes pour utiliser les cartes Google incluent :
Pour charger la bibliothèque, ouvrez l'Android SDK Manager et installez les "Google Play services SDK" si ce n'est pas déjà fait. Assurez-vous que la bibliothèque est bien intégrée dans votre projet.
Pour obtenir une clé API, vous devez suivre plusieurs étapes :
Utilisez la commande suivante pour obtenir l'empreinte SHA1 :
keytool -list -v -keystore "chemin/vers/debug.keystore" -alias androiddebugkey -storepass android -keypass android
Votre fichier AndroidManifest.xml doit contenir des permissions spécifiques pour accéder à Internet et aux services de localisation. Voici un exemple de configuration :
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="votre.package">
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<meta-data
android:name="com.google.android.maps.v2.API_KEY"
android:value="votre_clé_api" />
</manifest>
Pour afficher une carte, créez une activité qui utilise un fragment pour afficher la carte. Voici un exemple de code :
import android.app.Activity;
import android.os.Bundle;
import com.google.android.gms.maps.GoogleMap;
import com.google.android.gms.maps.MapFragment;
public class MainActivity extends Activity {
private GoogleMap map;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
map = ((MapFragment) getFragmentManager().findFragmentById(R.id.map)).getMap();
}
}
Pour ajouter des marqueurs, utilisez la méthode addMarker de l'objet GoogleMap. Voici un exemple :
map.addMarker(new MarkerOptions()
.position(new LatLng(48.870209, 2.306268))
.title("Champs Élysées")
.snippet("Un célèbre boulevard à Paris"));
Voici les points essentiels à retenir lors de l'utilisation de l'API Google de géolocalisation :
Pour obtenir une clé API, vous devez vous rendre sur la Google APIs Console, inscrire votre projet, et créer une clé API en fournissant votre empreinte SHA1 et le nom de votre paquetage.
Vous devez inclure des permissions pour l'accès à Internet, l'état du réseau, et la localisation fine. Cela permet à votre application d'accéder aux services de Google Maps.
Pour afficher une carte, créez une activité qui utilise un fragment pour la carte. Assurez-vous que votre fichier XML de mise en page contient un élément de fragment pour Google Maps.
Non, Google Play services ne sont pas supportés sur l'émulateur Android. Vous devez utiliser un appareil réel pour tester les fonctionnalités de géolocalisation.