Commencer

Ce guide de démarrage rapide vous permet de créer une application Android qui affiche une carte. Android Studio est l'environnement de développement recommandé pour créer une application avec le SDK Maps pour Android.

Étape 1. Télécharger Android Studio

Suivez les guides pour télécharger et installer Android Studio.

Étape 2. Installer le SDK des services Google Play

Ajoutez les services Google Play à Android Studio.

Étape 3. Créer un projet Google Maps

Procédez comme suit pour créer un projet d'application contenant une activité Google Maps :

  1. Lancez Android Studio.
  2. Créez un projet comme suit :
    • Si la boîte de dialogue Welcome to Android Studio (Bienvenue dans Android Studio) s'affiche, sélectionnez Start a new Android Studio project (Démarrer un nouveau projet Android Studio), disponible sous "Quick Start" (Démarrage rapide) à droite de la boîte de dialogue.
    • Sinon, cliquez sur File (Fichier) dans la barre de menu Android Studio, puis sur New (Nouveau), puis New Project (Nouveau projet).
  3. Dans la boîte de dialogue Choose your project (Choisir votre projet), sélectionnez l'onglet correspondant à votre plate-forme cible. La plupart des utilisateurs conservent l'option par défaut, Phone and Tablet (téléphone et tablette).
  4. Sélectionnez Google Maps Activity (Activité Google Maps), puis cliquez sur Next (Suivant).
  5. Saisissez le nom de l'application, le nom du package, l'emplacement du projet, le langage de programmation (Java ou Kotlin) et le niveau minimal d'API Android pris en charge par votre application, puis cliquez sur Finish (Terminer).

Android Studio démarre Gradle et crée votre projet. Cette opération peut prendre quelques secondes. Pour en savoir plus sur la création d'un projet dans Android Studio, consultez la [documentation Android Studio][studio-projects].

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 la façon d'obtenir une clé API Google Maps avant d'essayer d'exécuter l'application. La section suivante explique plus en détail comment obtenir la clé API.

Étape 4. Configurer une clé API Google Maps

  1. Activez la facturation dans votre projet. Pour plus d'informations, consultez Créer un compte de facturation.
  2. Dans Cloud Console, activez le SDK Maps pour Android pour votre projet. Pour plus d'informations, consultez Activer des API.
  3. Consultez le guide Obtenir une clé API pour obtenir, ajouter et restreindre une clé API.

Étape 5. Examiner le code

Examinez le code fourni par le modèle. Observez plus particulièrement les fichiers suivants dans votre projet Android Studio.

Fichier de mise en page XML

Par défaut, le fichier XML qui définit la mise en page 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 de l'activité Google Maps

Par défaut, le fichier Java qui définit l'activité Google Maps est appelé MapsActivity.java. Il doit contenir le code suivant après le nom du package :

Java

// Copyright 2020 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//      http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

package com.google.maps.example;

import androidx.appcompat.app.AppCompatActivity;

import android.os.Bundle;

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 AppCompatActivity implements OnMapReadyCallback {

    private GoogleMap mMap;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_maps);
        // Obtain the SupportMapFragment and get notified when the map is ready to be used.
        SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager()
                .findFragmentById(R.id.map);
        mapFragment.getMapAsync(this);
    }

    /**
     * Manipulates the map once available.
     * This callback is triggered when the map is ready to be used.
     * This is where we can add markers or lines, add listeners or move the camera. In this case,
     * we just add a marker near Sydney, Australia.
     *
     * If Google Play services is not installed on the device, the user will be prompted to install
     * it inside the SupportMapFragment. This method will only be triggered once the user has
     * installed Google Play services and returned to the app.
     */
    @Override
    public void onMapReady(GoogleMap googleMap) {
        mMap = googleMap;

        // Add a marker in Sydney 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));
    }
}

      

Kotlin

// Copyright 2020 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//      http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

package com.google.maps.example.kotlin

import androidx.appcompat.app.AppCompatActivity
import android.os.Bundle

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
import com.google.maps.example.R

internal class MapsActivity : AppCompatActivity(), OnMapReadyCallback {

    private lateinit var mMap: GoogleMap

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_maps)
        // Obtain the SupportMapFragment and get notified when the map is ready to be used.
        val mapFragment = supportFragmentManager
            .findFragmentById(R.id.map) as SupportMapFragment
        mapFragment.getMapAsync(this)
    }

    /**
     * Manipulates the map once available.
     * This callback is triggered when the map is ready to be used.
     * This is where we can add markers or lines, add listeners or move the camera. In this case,
     * we just add a marker near Sydney, Australia.
     * If Google Play services is not installed on the device, the user will be prompted to install
     * it inside the SupportMapFragment. This method will only be triggered once the user has
     * installed Google Play services and returned to the app.
     */
    override fun onMapReady(googleMap: GoogleMap) {
        mMap = googleMap

        // Add a marker in Sydney and move the camera
        val sydney = LatLng(-34.0, 151.0)
        mMap.addMarker(MarkerOptions()
            .position(sydney)
            .title("Marker in Sydney"))
        mMap.moveCamera(CameraUpdateFactory.newLatLng(sydney))
    }
}
      

Si votre fichier d'activité Google Maps 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 les développeurs sur votre appareil Android et configurer votre système afin qu'il détecte l'appareil.

Une autre solution consiste à exécuter votre application en utilisant l'Android Emulator. Utilisez l'outil AVD (Android Virtual Device) Manager pour configurer un ou plusieurs appareils virtuels que vous pourrez utiliser avec l'Android Emulator lors de la conception et de l'exécution de votre application. Pour choisir l'émulateur, assurez-vous d'utiliser Android 4.1.1 ou une version ultérieure et veillez à sélectionner une image qui inclut les API Google. Sinon, 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 un AVD cible x86 conformément aux instructions. Cela vous permettra de tirer davantage parti de l'émulateur.

Étape 7. Déployer et exécuter votre application

Dans Android Studio, cliquez sur l'option de menu Run (exécuter) ou sur l'icône du bouton de lecture pour exécuter l'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 la case d'option Launch emulator (Lancer l'émulateur) et choisir l'appareil virtuel que vous avez préalablement configuré.

Cliquez sur OK. Android Studio invoque Gradle pour créer l'application, puis affiche les résultats sur l'appareil ou sur l'émulateur. L'application peut mettre plusieurs minutes à s'ouvrir.

Étapes suivantes

Vous pouvez consulter un exemple de code.

Pour en savoir plus sur les objets de carte, consultez le guide du développeur.