Migrer vers les API de localisation et de contexte des services Google Play

Google recommande d'utiliser les API de localisation et de contexte des services Google Play dans les applications qui nécessitent des services de localisation. Si votre application utilise les API de localisation du framework, il est important de migrer vers les services Google Play pour bénéficier des dernières fonctionnalités fournies par Google.

Nous vous recommandons d'utiliser les services Google Play afin de bénéficier des services de localisation dans votre application pour les raisons suivantes :

  1. Les services Google Play offrent une interface simple et une surface d'API plus propre.
  2. Vous indiquez la qualité de service souhaitée, et les API gèrent à votre place les technologies sous-jacentes.
  3. Les API des services Google Play sont optimisées pour les performances et l'utilisation de la batterie.
  4. Les API des services Google Play sont entretenues de manière active. Google améliore constamment ses algorithmes et ajoute de nouvelles fonctionnalités.

Mettre à jour votre application

Les étapes suivantes décrivent le processus de mise à jour d'une application pour qu'elle utilise les API de localisation et de contexte :

  1. Configurer les services Google Play dans votre projet
  2. Utilisez l'API des paramètres de localisation pour valider les paramètres de localisation actuels.
  3. Utilisez les services Google Play pour des fonctionnalités complexes telles que le géorepérage, la reconnaissance de l'activité et la notoriété.
  4. Remplacez l'utilisation de l'API de localisation du framework par l'API Fused Location Provider.
  5. Supprimez les références à l'API de localisation du framework.

Configurer les services Google Play dans votre projet

Pour rendre les API de localisation et de contexte disponibles pour votre projet, vous devez ajouter une référence au dépôt Maven de Google et déclarer une dépendance aux API requises. Pour en savoir plus, consultez la section Configurer les services Google Play.

Utiliser l'API des paramètres de localisation

En utilisant l'API des paramètres de localisation, les applications fournissent le niveau de qualité de service souhaité, et l'API demande à l'utilisateur les modifications appropriées à apporter aux paramètres système. Pour utiliser l'API des paramètres de localisation dans votre application, procédez comme suit :

  1. Demandez l'autorisation d'accéder à la position dans le fichier manifeste d'application.
  2. Configurez un objet LocationRequest qui spécifie le niveau de qualité de service souhaité.
  3. Utilisez l'API des paramètres de localisation pour vérifier les paramètres actuels.

Pour en savoir plus, consultez Modifier les paramètres de localisation ou consultez les exemples de localisation Google Play pour obtenir des exemples de code.

Utiliser les services Google Play pour des fonctionnalités complexes

Les bibliothèques des services Google Play vous aident à implémenter de nouvelles expériences utilisateur liées au contexte et à la prise en compte de l'environnement de l'utilisateur. Les différentes bibliothèques de localisation et de contexte exploitent des capteurs supplémentaires au-delà de la localisation. Elles procèdent ainsi de manière économe en énergie pour fournir des données plus précises à votre application tout en réduisant l'impact sur l'autonomie de la batterie.

Intégrez ces bibliothèques à votre application au lieu d'écrire vos propres solutions personnalisées :

Remplacer l'API de localisation du framework par l'API Fused Location Provider

Vous pouvez utiliser l'API Fused Location Provider pour obtenir des données de localisation telles que la latitude et la longitude. L'API Fused Location Provider utilise un objet Location, tout comme l'API du framework de localisation, pour indiquer l'emplacement géographique. L'API propose des fonctionnalités permettant d'écouter des notifications de position et d'obtenir la dernière position connue. Toutes ces fonctionnalités font de l'API Fused Location Provider un bon candidat pour remplacer les composants qui utilisent l'API de localisation du framework avec un minimum de modifications sur le reste de l'application.

Obtenir la dernière position connue est un bon point de départ pour de nombreuses expériences, car il s'agit d'une opération rapide qui utilise les données de localisation demandées par n'importe quel client sur l'appareil. Pour suivre régulièrement la position, votre application peut s'abonner aux notifications de position, qui fournissent des données à jour et permettent des expériences plus complexes.

Supprimer les références à l'API de localisation du framework

Remplacez les références aux classes dans le package com.google.android.location par les classes du package com.google.android.gms.location, à l'exception des références à la classe Location, exploitée par l'API Fused Location Provider. Vous pouvez généralement supprimer de votre application les composants qui gèrent les différents fournisseurs tels que le GPS et le Wi-Fi. Les API de localisation et de contexte gèrent automatiquement ces fournisseurs.

Tester votre application

Pour exécuter une application qui utilise la dernière version des services Google Play, vous devez disposer d'un appareil sur lequel l'application Play Store est installée et sur lequel vous êtes connecté à un compte Google. À des fins de développement, vous pouvez utiliser les options suivantes :

  • Un appareil physique connecté à votre environnement de développement à l'aide d'un câble USB.
  • Un émulateur disposant de l'application Play Store installée.

Pour en savoir plus sur la connexion d'un appareil physique à votre environnement de développement, consultez la section Exécuter des applications sur un appareil physique. Pour créer un émulateur incluant l'application Play Store, consultez la section Créer et gérer des appareils virtuels.