Vous êtes prêt !

Pour passer à l'étape de développement, accédez à notre documentation pour les développeurs.

Activer Google Maps Android API

Pour commencer, nous allons vous guider à travers la console Google Developers et effectuer deux ou trois petites choses :

  1. Créer ou choisir un projet
  2. Activer Google Maps Android API
  3. Créer les clés appropriées
Continuer

Bibliothèque d'utilitaires de Google Maps Android API

Vous cherchez des fonctions avancées à ajouter à vos cartes ? La bibliothèque d'utilitaires de Google Maps Android API est une bibliothèque open-source de classes utiles pour toute une gamme d'applications. Le référentiel GitHub inclut les classes d'utilitaires et une application de démonstration qui illustre l'utilisation de chaque classe.

Dans cette vidéo, Chris Broadfoot présente la bibliothèque d'utilitaires, en mettant l'accent sur le décodage des polylignes, la géométrie sphérique et les icônes en forme de bulle.

Configuration rapide

Ajoutez la dépendance suivante au fichier de build Gradle de votre application :

dependencies {
    compile 'com.google.maps.android:android-maps-utils:0.4+'
}

Pour plus de détails, voir le guide de configuration.

Utilitaires

Une carte avec un calque GeoJSON

Importer des données GeoJSON dans votre carte

Vous pouvez stocker des fonctionnalités au format GeoJSON et utiliser cet utilitaire pour en effectuer le rendu sous forme de calque au-dessus d'une carte. Appelez addLayer() pour ajouter vos données GeoJSON à la carte. Vous pouvez également ajouter des fonctions individuelles en appelant addFeature() et en spécifiant un objet GeoJsonFeature.

Pour plus de détails, voir la documentation sur l'utilitaire GeoJSON de Google Maps Android.

Une carte avec un calque KML

Importer des données KML dans votre carte

Cet utilitaire permet de convertir des objets KML en formes géographiques et d'en effectuer le rendu sous forme de calque au-dessus d'une carte. Appelez addLayerToMap() pour ajouter votre calque à la carte. Vous pouvez accéder aux propriétés d'un objet KML en appelant getProperties() sur n'importe quel élément Placemark, GroundOverlay, Document ou Folder.

Pour plus de détails, voir la documentation sur l'utilitaire KML de Google Maps Android.

Une carte avec une carte thermique

Ajouter des cartes thermiques à votre carte

Les cartes thermiques permettent aux utilisateurs de mieux comprendre la répartition et l'intensité relative des points de données sur une carte. Au lieu de placer un marqueur sur chaque point géographique, les cartes thermiques utilisent des couleurs et des formes pour représenter la répartition des données. Créez un HeatmapTileProvider, en lui spécifiant un ensemble d'objets LatLng représentant les points d'intérêt sur la carte. Créez ensuite un nouveau TileOverlay, en lui spécifiant le fournisseur de tuiles de carte thermique, et ajoutez la superposition de tuiles à la carte.

Pour plus de détails, voir la documentation sur l'utilitaire de carte thermique de Google Maps Android.

Une carte avec des icônes en forme de bulle

Personnaliser des marqueurs avec des icônes en forme de bulle

Ajoutez un IconGenerator pour afficher des fragments d'informations sur vos marqueurs. Cet utilitaire vous permet de donner l'apparence de fenêtres d'info à vos icônes de marqueur, dans le sens où le marqueur lui-même peut contenir du texte et d'autres contenus. L'avantage est que plusieurs marqueurs peuvent rester ouverts en même temps, alors qu'une seule fenêtre d'info peut être ouverte à la fois. Vous pouvez également styliser les marqueurs, changer leur orientation et/ou contenu et changer l'image d'arrière plan/9-patch du marqueur.

Une carte avec un groupe de marqueurs

Gérer des groupes de marqueurs

Le ClusterManager vous aide à gérer plusieurs marqueurs à différents niveaux de zoom. Cela signifie que vous pouvez placer un grand nombre de marqueurs sur une carte sans qu'elle soit difficile à lire. Lorsque l'utilisateur affiche la carte à un niveau de zoom élevé, les différents marqueurs s'affichent sur la carte. Lorsque l'utilisateur effectue un zoom arrière, les marqueurs se regroupent pour faciliter la consultation de la carte.

Pour plus de détails, voir la documentation sur l'utilitaire de regroupement de marqueurs de Google Maps Android.

Une carte avec une polyligne encodée

Encoder et décoder des polylignes

L'utilitaire PolyUtil est utile pour convertir des polylignes et des polygones encodés en coordonnées de latitude/longitude, et inversement.

Dans Google Maps, les coordonnées de latitude et de longitude qui définissent une polyligne ou un polygone sont stockés sous forme de chaîne encodée. Voir l'explication détaillée sur l'encodage des polylignes. Vous pouvez recevoir cette chaîne encodée dans une réponse d'une API Google, telle que Google Maps Directions API.

Vous pouvez utiliser PolyUtil dans la bibliothèque d'utilitaires de Google Maps Android API afin d'encoder une séquence de coordonnées de latitude/longitude ('LatLngs') en chaîne de tracé encodée, et pour décoder une chaîne de tracé encodée en séquence de LatLngs. Cela garantit l'interopérabilité avec les Google Maps API Web Services.

Distance calculée entre deux points sur une carte

Calculer des distances, des superficies et des caps via la géométrie sphérique

Les utilitaires de géométrie sphérique de SphericalUtil vous permettent de calculer des distances, des superficies et des caps à partir de latitudes et de longitudes. Voici quelques-unes des méthodes disponibles dans cet utilitaire :

  • computeDistanceBetween() – Renvoie la distance, en mètres, entre deux coordonnées de latitude/longitude.
  • computeHeading() – Renvoie la direction, en degrés, entre deux coordonnées de latitude/longitude.
  • computeArea() – Renvoie la superficie, en mètres carrés, d'un tracé fermé sur la Terre.
  • interpolate() – Renvoie les coordonnées de latitude/longitude d'un point qui se trouve à une fraction donnée de la distance entre deux points donnés. Vous pouvez utiliser cet utilitaire pour animer un marqueur entre deux points, par exemple.

Voir la documentation de référence pour obtenir la liste complète des méthodes de cet utilitaire.

Envoyer des commentaires concernant…

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