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. À l'invite du système, 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 facteurs de forme 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. À l'invite du système, 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. (Les noms de ces fichiers dépendent des valeurs de configuration que vous avez saisies lors du paramétrage.) Notez que le fichier google_maps_api.xml contient des instructions sur l'obtention d'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 Key for Android applications. 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.

Pour obtenir votre clé d'API, choisissez l'une des méthodes suivantes :

  • La 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 Developers Console et fournit des informations via des paramètres d'URL, réduisant ainsi la saisie manuelle requise de votre part.
    2. Suivez les instructions pour créer un nouveau projet sur la console ou sélectionnez un projet existant.
    3. Créez une clé d'API Android pour votre projet de console.
    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.
  • Une méthode un petit peu moins rapide : Utilisez les informations d'identification fournies dans le fichier google_maps_api.xml créé par Android Studio :

    1. Copiez les informations d'identification fournies dans le fichier google_maps_api.xml.
    2. Allez à la Google Developers 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. Pour plus de détails, voir le processus complet.
  • 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.

Remarque : Si vous utilisez Google Maps Mobile SDK for Work, vous devez également activer le Google Maps Mobile SDK for Work pour projet API sur la Google Developers Console.

Étape 5. Ouvrir la carte 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 {
    @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 map) {
        // Add a marker in Sydney, Australia, and move the camera.
        LatLng sydney = new LatLng(-34, 151);
        map.addMarker(new MarkerOptions().position(sydney).title("Marker in Sydney"));
        map.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. Vous devez disposer d'une image d'émulateur avec la plateforme Google API sous Android 4.2.2 ou version ultérieure. Prenez 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.

Envoyer des commentaires concernant…

Google Maps Android API
Google Maps Android API
Besoin d'aide ? Consultez notre page d'assistance.