Demander l'autorisation d'accéder à la position

Il existe plusieurs façons de demander des informations sur la position de l'utilisateur sur Android, et la meilleure méthode varie selon le cas d'utilisation. Ce guide décrit différents scénarios d'accès à la position et explique comment demander l'autorisation d'accéder à la position dans chaque cas.

Pour commencer, consultez les bonnes pratiques pour toutes les autorisations d'exécution, ainsi que les conseils plus généraux pour minimiser les demandes d'autorisation.

Types d'accès à la position

Chaque autorisation présente une combinaison des caractéristiques suivantes :

Localisation au premier plan

Si votre application contient une fonctionnalité qui ne partage ou ne reçoit des informations de localisation qu'une seule fois, ou pendant une durée déterminée, un accès à la localisation au premier plan est nécessaire. Quelques exemples :

  • Dans une application de navigation, une fonctionnalité permet aux utilisateurs d'obtenir des instructions de navigation détaillées.
  • Dans une application de chat, une fonctionnalité permet aux utilisateurs de partager leur position actuelle avec un autre utilisateur.

Le système considère que votre application utilise la localisation au premier plan si l'une des fonctionnalités de votre application accède à la position actuelle de l'appareil dans l'une des situations suivantes :

  • Une activité liée à votre application est visible.

  • Votre application exécute un service de premier plan. Lorsqu'un service de premier plan est en cours d'exécution, le système le fait savoir à l'utilisateur en affichant une notification permanente. Votre application conserve l'accès lorsqu'elle est placée en arrière-plan (par exemple, lorsque l'utilisateur appuie sur le bouton Accueil ou éteint l'écran de son appareil).

    Vous devez également déclarer un type de service de premier plan location, comme indiqué dans l'extrait de code suivant. Sur Android 10 (niveau d'API 29) ou version ultérieure, vous devez déclarer ce type de service de premier plan.

    <!-- Recommended for Android 9 (API level 28) and lower. -->
<!-- Required for Android 10 (API level 29) and higher. -->
<service
    android:name="MyNavigationService"
    android:foregroundServiceType="location" ... >
    <!-- Any inner elements would go here. -->
</service>

Vous déclarez que la localisation au premier plan est nécessaire lorsque votre application demande l'autorisation ACCESS_COARSE_LOCATION ou ACCESS_FINE_LOCATION, comme indiqué dans l'extrait de code suivant :

<manifest ... >
  <!-- Always include this permission -->
  <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

  <!-- Include only if your app benefits from precise location access. -->
  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
</manifest>

Accès ponctuel : en plus d'accéder aux données de localisation au premier plan, certains cas d'utilisation ont la particularité de n'avoir besoin d'accéder à la localisation de l'utilisateur qu'à des moments précis de l'expérience de l'application, au lieu de la mettre à jour de manière continue tout au long de l'utilisation de l'application. Dans ce cas, les applications doivent utiliser le bouton de localisation pour demander l'accès à la localisation pour cette session d'utilisation de l'application. De plus, si votre application cible Android 17 (niveau d'API 37) ou version ultérieure et ne contient que des fonctionnalités nécessitant un accès à la localisation basé sur la session, les règles de Google Play vous obligent à utiliser le bouton de localisation. Pour en savoir plus, consultez le Règlement concernant le bouton de localisation.

Localisation en arrière-plan

Une application nécessite un accès à la localisation en arrière-plan si l'une de ses fonctionnalités partage en continu sa position avec d'autres utilisateurs ou utilise l'API Geofencing. Quelques exemples :

  • Dans une application de partage de position avec la famille, une fonctionnalité permet aux utilisateurs de partager leur position en continu avec les membres de leur famille.
  • Dans une application IoT, une fonctionnalité permet à l'utilisateur de configurer ses appareils connectés de sorte qu'ils s'éteignent lorsqu'il quitte la maison, puis se rallument à son retour.

Le système considère que votre application utilise la localisation en arrière-plan si elle accède à la position actuelle de l'appareil dans une situation autre que celles décrites dans la section Localisation au premier plan. La précision de la localisation en arrière-plan est identique à celle de la localisation au premier plan, qui dépend des autorisations d'accès à la position déclarées par votre application.

Sur Android 10 (niveau d'API 29) ou version ultérieure, vous devez déclarer l'autorisation ACCESS_BACKGROUND_LOCATION dans le fichier manifeste de votre application afin de demander l'accès à la localisation en arrière-plan au moment de l'exécution. Sur les versions antérieures d'Android, lorsque votre application reçoit un accès à la localisation au premier plan, elle reçoit également automatiquement l'accès à la localisation en arrière-plan.

<manifest ... >
  <!-- Required only when requesting background location access on
       Android 10 (API level 29) and higher. -->
  <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
</manifest>

Précision

Android est compatible avec les niveaux suivants de précision de la position :

Approximative
Fournit une estimation de la position de l'appareil. Si cette estimation provient de LocationManagerService ou FusedLocationProvider, la précision est d'environ 3 kilomètres carrés. Votre application peut recevoir une position avec ce niveau de précision lorsque vous déclarez l'autorisation ACCESS_COARSE_LOCATION, mais pas l'autorisation ACCESS_FINE_LOCATION.
Exacte
Fournit une estimation de la position de l'appareil aussi précise que possible. Si l'estimation de la position provient de LocationManagerService ou FusedLocationProvider, la précision est généralement de 50 mètres environ, voire de l'ordre de quelques mètres (ou moins) dans certains cas. Votre application peut recevoir une position avec ce niveau de précision lorsque vous déclarez l'autorisation ACCESS_FINE_LOCATION.

Si l'utilisateur accorde l'autorisation d'accéder à la position approximative, votre application n'a accès qu'à la position approximative, quelles que soient les autorisations d'accès déclarées par votre application.

Le fait que l'utilisateur n'accorde qu'un accès à la position approximative ne devrait pas empêcher votre application de fonctionner. Si une fonctionnalité de votre application a absolument besoin de la position exacte à l'aide de l'autorisation ACCESS_FINE_LOCATION, vous pouvez demander à l'utilisateur d'autoriser l'application à accéder à cette précision de localisation.

Rappel d'octroi de la localisation en arrière-plan

Sur Android 10 (niveau d'API 29) ou version ultérieure, la première fois qu'une fonctionnalité de votre application accède à la localisation en arrière-plan de l'appareil après que l'utilisateur a accordé l'accès à la localisation en arrière-plan, le système planifie une notification à envoyer à l'utilisateur. Cette notification lui rappelle qu'il a accordé à l'application un accès permanent à la position de l'appareil. La figure 8 montre un exemple de notification.

Vérifier les exigences de localisation dans les dépendances du SDK de votre application

Vérifiez si votre application utilise des SDK qui dépendent des autorisations d'accéder à la position, en particulier l'autorisation ACCESS_FINE_LOCATION. Pour en savoir plus, consultez l'article de blog Comprendre les comportements de vos dépendances SDK sur Medium.

Ressources supplémentaires

Pour en savoir plus sur les autorisations d'accéder à la position sur Android, consultez les ressources suivantes :

Ateliers de programmation

Vidéos

Exemples