Premiers pas

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 :

1. Démarrez Android Studio.

2. 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.

3. 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.

4. 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.
5. Sélectionnez Google Maps Activity dans la boîte de dialogue « Add an activity to Mobile ». Cliquez ensuite sur Next.
6. 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 :
  1. 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.
  2. Suivez les instructions pour créer un nouveau projet sur la Google API Console ou sélectionnez un projet existant.
  3. Créez une clé d'API restreinte à Android pour votre projet.
  4. 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.
• 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 :
  1. Copiez les informations d'identification fournies dans le fichier google_maps_api.xml.
  2. Allez à la Google API Console dans votre navigateur.
  3. Utilisez les informations d'identification copiées pour ajouter votre application à une clé d'API existante ou pour en créer une nouvelle.

• 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.