Cette page a été traduite par l'API Cloud Translation.

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

Pour protéger la vie privée des utilisateurs, les applications qui utilisent les services de localisation doivent demander l'autorisation d'accéder à la position.

Plusieurs autorisations sont liées à la position. Les autorisations que vous demandez et la manière dont vous les demandez dépendent des exigences de localisation du cas d'utilisation de votre application.

Cette page décrit les différents types d'exigences de localisation et explique comment demander l'autorisation d'accéder à la position dans chaque cas.

Pour demander des autorisations d'accéder à la position, suivez les bonnes pratiques pour toutes les autorisations d'exécution.

Types d'accès à la position

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

Catégorie: localisation au premier plan ou localisation en arrière-plan.
Précision : position exacte ou approximative.

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.
```


<service
    android:name="MyNavigationService"
    android:foregroundServiceType="location" ... >
    
</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>

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 et 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 cette estimation 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 position de l'appareil en arrière-plan après que l'utilisateur a accordé ce type d'accès, 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 Découvrir les comportements de vos dépendances de 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

Bonnes pratiques concernant la confidentialité

Vidéos

Déterminer une utilisation potentielle de la localisation en arrière-plan

Exemples

Application exemple afin d'illustrer comment utiliser les autorisations d'accéder à la position

À propos de la position géographique de l'utilisateur

Obtenir la dernière localisation connue