Ce guide de démarrage rapide vous permet d'ajouter une carte à une application Android. Android Studio est l'environnement de développement recommandé pour créer une application à l'aide de Google Maps Android API.
Étape 1. Télécharger Android Studio
Suivez les instructions pour télécharger et installer Android Studio.
Étape 2. Installer le SDK des services Google Play
Ajoutez le package de services Google Play à Android Studio.
Étape 3. Créer un projet Google Maps
Procédez comme suit pour créer un nouveau projet d'application contenant une activité de carte :
- Démarrez Android Studio.
-
Créez un nouveau projet comme suit :
- Si la boîte de dialogue Welcome to Android Studio s'affiche, choisissez Start a new Android Studio project, disponible sous « Quick Start » à droite de la boîte de dialogue.
- Sinon, cliquez sur File dans la barre de menus Android Studio, puis sur New, New Project.
-
Lorsque vous y êtes invité, saisissez le nom de votre application, le domaine de la société et l'emplacement du projet. Cliquez ensuite sur Next.
- Sélectionnez les formats dont vous avez besoin pour votre application. Si vous n'êtes pas sûr de ce dont vous avez besoin, sélectionnez simplement Phone and Tablet. Cliquez ensuite sur Next.
- Sélectionnez Google Maps Activity dans la boîte de dialogue « Add an activity to Mobile ». Cliquez ensuite sur Next.
- Lorsque vous y êtes invité, saisissez le nom de l'activité, le nom de la disposition (layout) et le titre. Les valeurs par défaut conviennent. Cliquez ensuite sur Finish.
Android Studio démarre Gradle et crée votre projet. Cette opération peut prendre quelques secondes. Pour plus d'informations sur la création d'un projet dans Android Studio, voir la documentation Android Studio.
Une fois le projet créé, Android Studio ouvre les fichiers google_maps_api.xml
et
MapsActivity.java
dans l'éditeur. (Notez que votre activité peut avoir
un nom différent, mais il s'agira du nom défini durant la configuration.) Notez
que le fichier google_maps_api.xml
contient des instructions sur comment obtenir
une clé d'API Google Maps afin de pouvoir exécuter l'application. La section suivante
explique plus en détail comment obtenir une clé d'API.
Étape 4. Obtenir une clé d'API Google Maps
Votre application doit disposer d'une clé d'API pour pouvoir accéder aux serveurs Google Maps. Le type de clé dont vous avez besoin est une clé d'API avec une restriction pour les applications Android. Cette clé est gratuite. Vous pouvez l'utiliser avec n'importe quelle application qui appelle Google Maps Android API ; elle prend en charge un nombre illimité d'utilisateurs.
Choisissez l'une des méthodes suivantes pour obtenir votre clé d'API depuis Android Studio :
- Méthode la plus simple et la plus rapide : Utilisez le lien fourni dans le fichier
google_maps_api.xml
qu'Android Studio a créé pour vous :- Copiez le lien fourni dans le fichier
google_maps_api.xml
et collez-le dans votre navigateur. Ce lien vous dirige vers la Google API Console et fournit les informations requises pour la Google API Console via des paramètres d'URL, réduisant ainsi la saisie manuelle nécessaire de votre part. - Suivez les instructions pour créer un nouveau projet sur la Google API Console ou sélectionnez un projet existant.
- Créez une clé d'API restreinte à Android pour votre projet.
- Copiez la clé d'API obtenue, retournez dans Android Studio et collez la clé d'API dans l'élément <string> du fichier
google_maps_api.xml
.
- Copiez le lien fourni dans le fichier
- Méthode un peu moins rapide : Utilisez les informations d'identification fournies dans le fichier
google_maps_api.xml
qu'Android Studio a créé pour vous :- Copiez les informations d'identification fournies dans le fichier
google_maps_api.xml
. - Allez à la Google API Console dans votre navigateur.
- Utilisez les informations d'identification copiées pour ajouter votre application à une clé d'API existante ou pour en créer une nouvelle.
- Copiez les informations d'identification fournies dans le fichier
- Le processus complet d'obtention d'une clé d'API : si aucune des options précédentes ne fonctionne pour vous, suivez le processus complet.
Étape 5. Hello Map! et examiner le code
Examinez le code fourni par le modèle. Observez plus particulièrement les fichiers suivants dans votre projet Android Studio.
Fichier XML de disposition (layout)
Par défaut, le fichier XML qui définit la disposition de l'application est
res/layout/activity_maps.xml
. Il contient le code suivant :
<fragment xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:id="@+id/map"
tools:context=".MapsActivity"
android:name="com.google.android.gms.maps.SupportMapFragment" />
Fichier Java d'activité des cartes
Par défaut, le fichier Java qui définit l'activité des cartes est appelé
MapsActivity.java
. Il doit contenir le code suivant après le
nom du package :
import android.os.Bundle;
import android.support.v4.app.FragmentActivity;
import com.google.android.gms.maps.CameraUpdateFactory;
import com.google.android.gms.maps.GoogleMap;
import com.google.android.gms.maps.OnMapReadyCallback;
import com.google.android.gms.maps.SupportMapFragment;
import com.google.android.gms.maps.model.LatLng;
import com.google.android.gms.maps.model.MarkerOptions;
public class MapsActivity extends FragmentActivity implements OnMapReadyCallback {
private GoogleMap mMap;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_maps);
SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager()
.findFragmentById(R.id.map);
mapFragment.getMapAsync(this);
}
@Override
public void onMapReady(GoogleMap googleMap) {
mMap = googleMap;
// Add a marker in Sydney, Australia, and move the camera.
LatLng sydney = new LatLng(-34, 151);
mMap.addMarker(new MarkerOptions().position(sydney).title("Marker in Sydney"));
mMap.moveCamera(CameraUpdateFactory.newLatLng(sydney));
}
}
Si votre fichier d'activité des cartes ne contient pas le code ci-dessus, remplacez son contenu par le code ci-dessus, après le nom du package.
Étape 6. Connecter un appareil Android
Le moyen le plus simple de voir votre application en action consiste à connecter un appareil Android à votre ordinateur. Suivez les instructions pour activer les options pour développeurs sur votre appareil Android et configurer votre application et votre système afin qu’ils détectent l'appareil.
Une autre solution consiste à exécuter votre application en utilisant l'émulateur Android. Utilisez Android Virtual Device (AVD) Manager pour configurer un ou plusieurs appareils virtuels que vous pourrez utiliser avec l'émulateur Android lors de la création ou de l'exécution de votre application. Lorsque vous choisissez votre émulateur, assurez-vous d'utiliser Android 4.2.2 ou une version ultérieure, et veillez à choisir une image qui inclut les API Google. Autrement, l'application ne disposera pas des API requises pour son exécution. Prenez également note des instructions pour configurer l'accélération de la machine virtuelle, que vous devez utiliser avec l'option x86 target AVD conformément aux instructions. Ce paramétrage permet de bénéficier d'une meilleure expérience avec l'émulateur.
Étape 7. Créer et exécuter votre application
Dans Android Studio, cliquez sur l'option de menu Run (ou sur l'icône du bouton de lecture) pour lancer votre application.
Lorsque vous êtes invité à choisir un appareil, sélectionnez l'une des options suivantes :
- Sélectionnez l'appareil Android qui est connecté à votre ordinateur.
- Vous pouvez également sélectionner le bouton radio Launch emulator et choisir l'appareil virtuel que vous avez préalablement configuré.
Cliquez sur OK. Android Studio invoque alors Gradle pour créer votre application, puis affiche les résultats sur l'appareil ou sur l'émulateur. L'application peut mettre plusieurs minutes à s'ouvrir.
Vous devriez voir une carte avec un marqueur positionné sur Sydney en Australie. Si vous ne voyez pas de carte, vérifiez que vous avez bien effectué toutes les étapes décrites sur cette page. Vérifiez en particulier que vous avez bien ajouté une clé d'API comme décrit ci-dessus.
Étapes suivantes
Vous pouvez consulter un exemple de code.
Vous pouvez en apprendre davantage sur les objets de carte dans le guide du développeur.