Sur cette page

Qt Positioning sur Android

Utilisation d'Qt Positioning depuis les services Android

L'utilisation d'Qt Positioning depuis un service nécessite plusieurs étapes supplémentaires, selon la version d'Android. Les sections ci-dessous fournissent plus de détails sur ces étapes.

Remarque : depuis Android 8 (niveau d'API 26), le système d'exploitation limite la fréquence à laquelle une application peut récupérer la position actuelle de l'utilisateur lorsqu'elle s'exécute en arrière-plan. En règle générale, l'application ne pourra recevoir des mises à jour de position que quelques fois par heure. Pour plus d'informations, consultez la section « Limites de localisation en arrière-plan ».

Utilisation d’un service au premier plan

Depuis Android 8 (niveau d'API 26), le service en arrière-plan peut être arrêté par le système d'exploitation Android lorsque l'application passe en arrière-plan. Cela se produit généralement après environ une minute d'exécution en arrière-plan. Pour que le service de localisation continue de fonctionner, celui-ci doit être implémenté en tant que service au premier plan. Ce type de service affiche une notification dans la barre d’état, qui ne peut être supprimée tant que le service n’est pas arrêté ou retiré du premier plan. Cela permet à l’utilisateur d’être toujours informé des activités importantes se déroulant en arrière-plan.

Remarque : depuis Android 9 (niveau d’API 28), les services en avant-plan nécessitent une autorisation spéciale « FOREGROUND_SERVICE ». Consultez la documentation Android pour plus de détails sur l’implémentation des services en avant-plan.

Utilisation de l'autorisation de localisation en arrière-plan

Depuis Android 10 (niveau d’API 29), le service doit demander l’autorisation ACCESS_BACKGROUND_LOCATION. Elle doit être ajoutée au fichier ` AndroidManifest.xml ` comme suit :

<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />

Remarque : une fois l’autorisation ajoutée au fichier ` AndroidManifest.xml`, il est toujours nécessaire d’autoriser explicitement l’accès permanent aux services de localisation pour l’application. Pour ce faire, accédez à Settings -> Apps, sélectionnez l’application concernée, ouvrez ses autorisations et spécifiez l’autorisation « Allow all the time » pour la localisation (voir la capture d’écran ci-dessous).

Écran des paramètres d'autorisation de localisation sur Android

Consultez la documentation Android intitulée « Accès à la localisation en arrière-plan » pour plus de détails.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.