Aus Datenschutzgründen müssen Apps, die Standortdienste verwenden, den Standort anfordern Berechtigungen.
Beachten Sie beim Anfordern von Berechtigungen zur Standortermittlung dieselben Best Practices wie Sie für jede andere Laufzeitberechtigung. Ein wichtiger Unterschied bei den Berechtigungen zur Standortermittlung ist, dass das mehrere Berechtigungen in Bezug auf den Standort hat. Welche Berechtigungen Sie und wie Sie sie anfordern, hängen von den Standortanforderungen für Ihre Anwendungsfall der App.
Auf dieser Seite werden die verschiedenen Standortanforderungen beschrieben und um jeweils die Berechtigung zur Standortermittlung anzufordern.
Arten des Standortzugriffs
Jede Berechtigung hat eine Kombination der folgenden Eigenschaften:
- Kategorie: Entweder Position im Vordergrund oder Hintergrund Standort
- Genauigkeit: Entweder der genaue oder der ungefähre Standort.
Vordergrundstandort
Wenn Ihre App eine Funktion enthält, die nur Standortinformationen teilt oder empfängt einmal oder für einen festgelegten Zeitraum erfordert, dass diese Funktion Standortzugriff. Hier einige Beispiele:
- Innerhalb einer Navigations-App können Nutzende eine detaillierte Routenführung Wegbeschreibungen.
- Eine Funktion in einer Messaging-App ermöglicht es Nutzern, ihren aktuellen Standort zu teilen. mit einem anderen Nutzer.
Das System geht davon aus, dass Ihre App die Standortermittlung im Vordergrund verwendet, wenn eine Funktion Ihre App an einem der folgenden Orte auf den aktuellen Standort des Geräts zugreift Situationen:
- Eine Aktivität, die zu deiner App gehört, ist sichtbar.
In deiner App wird ein Dienst im Vordergrund ausgeführt. Wenn ein Dienst im Vordergrund informiert das System die Nutzer über eine dauerhafte Benachrichtigung. Ihre App behält den Zugriff, wenn sie im Hintergrund platziert wird, z. B. wenn der Der Nutzer drückt die Startbildschirmtaste auf seinem Gerät oder dreht das Display des Geräts. deaktiviert.
Außerdem sollten Sie einen Dienst im Vordergrund Art von
location
, wie im folgenden Code-Snippet gezeigt. Android 10 (API) Level 29) und höher müssen Sie diesen Typ von Dienst im Vordergrund deklarieren.<!-- 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>
Sie erklären, dass die Standortermittlung im Vordergrund erforderlich ist, wenn Ihre App
ACCESS_COARSE_LOCATION
oder die
ACCESS_FINE_LOCATION
wie im folgenden Snippet gezeigt:
<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>
Standort im Hintergrund
Eine App benötigt Zugriff auf die Standortermittlung im Hintergrund, wenn eine Funktion innerhalb der App teilt den Standort ständig mit anderen Nutzern oder verwendet Geofencing API hinzu. Hier einige Beispiele:
- Innerhalb einer Familien-App zur Standortfreigabe können Nutzer Standort mit Familienmitgliedern teilen.
- In einer IoT-App können Nutzer mit einer Funktion ihre Smart-Home-Geräte konfigurieren, z. B. die sich ausschalten, wenn der Nutzer das Zuhause verlässt, und wieder einschalten, wenn der wenn Nutzende nach Hause kommen.
Das System nutzt die Standortermittlung im Hintergrund für deine App, wenn sie auf die Standort des Geräts in allen Situationen, die nicht in den im Vordergrund ein. Die Genauigkeit der Standortermittlung im Hintergrund beträgt entspricht der Genauigkeit der Standortermittlung im Vordergrund, die von die von Ihrer App deklarierten Berechtigungen zur Standortermittlung verwenden.
Unter Android 10 (API-Level 29) und höher musst du die
ACCESS_BACKGROUND_LOCATION
im Manifest deiner App, um die Standortermittlung im Hintergrund anzufordern
Zugriff während der Laufzeit. In früheren Versionen von
Wenn deine App unter Android Zugriff auf die Standortermittlung im Vordergrund erhält,
erhält ebenfalls Zugriff auf die Standortermittlung im Hintergrund.
<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>
Richtigkeit
Android unterstützt die folgenden Genauigkeitsstufen:
- Ungefähr
- Liefert eine Schätzung des Gerätestandorts. Stammt diese Standortschätzung
LocationManagerService
oderFusedLocationProvider
, Diese Schätzung ist auf etwa 3 Quadratkilometer genau (ca.1,2 Quadratkilometer Kilometer). Deine App kann Standorte mit dieser Genauigkeit empfangen, wenn du die BerechtigungACCESS_COARSE_LOCATION
deklarieren, aber nicht die Berechtigung „ACCESS_FINE_LOCATION
“ - Genau
- Eine möglichst genaue Schätzung des Gerätestandorts Wenn die
Standortschätzung stammt von
LocationManagerService
oderFusedLocationProvider
, liegt diese Schätzung normalerweise innerhalb von etwa 50 Metern und ist manchmal auf wenige Meter oder besser genau. Ihre App kann Folgendes empfangen: Standorte mit dieser Genauigkeit angeben, wenn Sie dasACCESS_FINE_LOCATION
Berechtigung.
Wenn der Nutzer die Berechtigung zur ungefähren Standortermittlung erteilt, geschieht Folgendes: hat Ihre App nur Zugriff auf den ungefähren Standort, unabhängig davon, Berechtigungen, die in Ihrer App deklariert sind.
Ihre App sollte auch dann funktionieren, wenn der Nutzer nur den ungefähren Standort gewährt
Zugriff haben. Wenn eine Funktion Ihrer App unbedingt Zugriff auf den genauen Standort benötigt
Mit der Berechtigung ACCESS_FINE_LOCATION
können Sie den Nutzer bitten, Ihre
App, um auf den genauen Standort zuzugreifen.
Standortzugriff zur Laufzeit anfordern
Wenn eine Funktion in deiner App Standortzugriff benötigt, warte, bis der Nutzer darauf reagiert bevor Sie die Berechtigungsanfrage stellen. Dieser Workflow folgt der Best Practice für das Abfragen von Laufzeitberechtigungen im entsprechenden Kontext, wie in den in der die App-Anforderung Berechtigungen
Abbildung 1 zeigt ein Beispiel für die Durchführung dieses Vorgangs. Die App enthält ein „Standort teilen“ für die der Zugriff auf die Standortermittlung im Vordergrund erforderlich ist. Die App fordert jedoch erst dann die Berechtigung zur Standortermittlung an, wenn der Nutzer die Schaltfläche Standort teilen:
Der Nutzer kann nur den ungefähren Standort gewähren
Unter Android 12 (API-Level 31) oder höher können Nutzer anfordern, dass Ihre App
nur den ungefähren Standort angeben, auch wenn Ihre App die
ACCESS_FINE_LOCATION
Laufzeitberechtigung.
Fordere zum Umgang mit diesem potenziellen Nutzerverhalten nicht die ACCESS_FINE_LOCATION
an
für sich alleinstehende Genehmigungen. Fordern Sie stattdessen beide ACCESS_FINE_LOCATION
an
und die
ACCESS_COARSE_LOCATION
in einer einzelnen Laufzeitanfrage. Wenn Sie versuchen, nur
ACCESS_FINE_LOCATION
, wird die Anfrage bei einigen Releases von
Android 12 Wenn Ihre App für Android 12 oder
höher ist, protokolliert das System die folgende Fehlermeldung
Logcat:
ACCESS_FINE_LOCATION must be requested with ACCESS_COARSE_LOCATION.
Wenn deine App sowohl ACCESS_FINE_LOCATION
als auch ACCESS_COARSE_LOCATION
anfordert,
Das Dialogfeld für Systemberechtigungen enthält die folgenden Optionen für den Nutzer:
- Genau: Die App kann genaue Standortinformationen abrufen.
- Ungefähr: Die App kann nur den ungefähren Standort abrufen.
Abbildung 3 zeigt, dass das Dialogfeld ein visuelles Element enthält. einen Hinweis für beide Optionen, um den Nutzenden die Auswahl zu erleichtern. Nachdem sich die Nutzenden für ein können Sie auf eine von drei Schaltflächen tippen, um die Dauer der Berechtigungserteilung.
Unter Android 12 und höher können Nutzer die Systemeinstellungen aufrufen. , um die bevorzugte Standortgenauigkeit für eine App festzulegen, unabhängig von der SDK-Zielversion. Dies gilt auch dann, wenn deine App auf einem Gerät installiert ist. mit Android 11 oder niedriger. Der Nutzer führt dann ein Upgrade der auf Android 12 oder höher.
ACCESS_COARSE_LOCATION
an.ACCESS_FINE_LOCATION
als auch
ACCESS_COARSE_LOCATION
in einer einzelnen Laufzeitanfrage.
Die Nutzerauswahl wirkt sich auf die Erteilung von Berechtigungen aus
In der folgenden Tabelle sehen Sie die Berechtigungen, die Ihrer App vom System erteilt werden. basierend auf den Optionen, die der Nutzer im Dialogfeld für die Berechtigungslaufzeit auswählt:
Genau | Ungefähr | |
---|---|---|
Bei Nutzung der App | ACCESS_FINE_LOCATION und ACCESS_COARSE_LOCATION |
ACCESS_COARSE_LOCATION |
Nur dieses Mal | ACCESS_FINE_LOCATION und ACCESS_COARSE_LOCATION |
ACCESS_COARSE_LOCATION |
Deny | Keine Berechtigung zur Standortermittlung | Keine Berechtigung zur Standortermittlung |
Um herauszufinden, welche Berechtigungen das System Ihrer App gewährt hat, gehen Sie zu den Rückgabewert Ihrer Berechtigungsanfrage. Sie können Jetpack-Bibliotheken im Code verwenden ähnlich wie die folgenden, oder Sie können Plattformbibliotheken verwenden, in denen Sie Berechtigungsanfragecode verwalten Sie selbst.
Kotlin
val locationPermissionRequest = registerForActivityResult( ActivityResultContracts.RequestMultiplePermissions() ) { permissions -> when { permissions.getOrDefault(Manifest.permission.ACCESS_FINE_LOCATION, false) -> { // Precise location access granted. } permissions.getOrDefault(Manifest.permission.ACCESS_COARSE_LOCATION, false) -> { // Only approximate location access granted. } else -> { // No location access granted. } } } // ... // Before you perform the actual permission request, check whether your app // already has the permissions, and whether your app needs to show a permission // rationale dialog. For more details, see Request permissions. locationPermissionRequest.launch(arrayOf( Manifest.permission.ACCESS_FINE_LOCATION, Manifest.permission.ACCESS_COARSE_LOCATION))
Java
ActivityResultLauncher<String[]> locationPermissionRequest = registerForActivityResult(new ActivityResultContracts .RequestMultiplePermissions(), result -> { Boolean fineLocationGranted = result.getOrDefault( Manifest.permission.ACCESS_FINE_LOCATION, false); Boolean coarseLocationGranted = result.getOrDefault( Manifest.permission.ACCESS_COARSE_LOCATION,false); if (fineLocationGranted != null && fineLocationGranted) { // Precise location access granted. } else if (coarseLocationGranted != null && coarseLocationGranted) { // Only approximate location access granted. } else { // No location access granted. } } ); // ... // Before you perform the actual permission request, check whether your app // already has the permissions, and whether your app needs to show a permission // rationale dialog. For more details, see Request permissions. locationPermissionRequest.launch(new String[] { Manifest.permission.ACCESS_FINE_LOCATION, Manifest.permission.ACCESS_COARSE_LOCATION });
Upgrade auf den genauen Standort anfordern
Du kannst den Nutzer bitten, den Zugriff deiner App von der Standortermittlung auf
genauer Standort erfasst. Bevor Sie den Nutzer bitten, den Zugriff Ihrer App auf
Den genauen Standort sollten Sie
jedoch überlegen, ob der Anwendungsfall Ihrer App
erfordert diese Präzision. Wenn deine App ein Gerät mit einem Gerät in der Nähe koppeln muss
Geräte über Bluetooth oder WLAN verbinden können, sollten Sie ein Begleitgerät verwenden.
Kopplung oder Bluetooth
Berechtigungen
fordert die Berechtigung ACCESS_FINE_LOCATION
an.
Um den Nutzer anzufordern, dass er den Standortzugriff Ihrer App von ungefähr auf genau, gehen Sie so vor:
- Erläutern Sie gegebenenfalls, warum Ihre App die Funktion Berechtigung
- Berechtigungen
ACCESS_FINE_LOCATION
undACCESS_COARSE_LOCATION
anfordern wieder zusammen. Da der Nutzer dem System bereits erlaubt hat, ungefähren Standort angeben, unterscheidet sich das Systemdialogfeld dieses Mal, wie in Abbildung 4 dargestellt, und Abbildung 5:
Anfänglich nur Standort im Vordergrund anfordern
Auch wenn mehrere Funktionen Ihrer App Zugriff auf den Standort erfordern, aber nur einige erfordern Zugriff auf die Standortermittlung im Hintergrund. Daher ist es empfohlen, dass Ihre App inkrementelle Anfragen für den Standort ausführt Berechtigungen, um Zugriff auf die Standortermittlung im Vordergrund und dann auf die Standortermittlung im Hintergrund zu erhalten Zugriff haben. Durch inkrementelle Anfragen geben Sie Nutzern mehr Kontrolle und da sie besser verstehen, welche Funktionen Ihrer App Zugriff auf Standortermittlung im Hintergrund.
Abbildung 6 zeigt ein Beispiel für eine App, die für die Verarbeitung -Anfragen. Sowohl die Option "Aktuellen Standort anzeigen" und „Orte in der Nähe empfehlen“ Funktionen erfordern den Zugriff auf die Standortermittlung im Vordergrund. Nur „Orte in der Nähe empfehlen“ erfordert jedoch den Zugriff auf die Standortermittlung im Hintergrund.
So führen Sie inkrementelle Anfragen durch:
-
Zunächst sollte Ihre App Nutzende zu Funktionen führen, die eine Zugriff auf Standort im Vordergrund, z. B. „Standort teilen“ in Abbildung 1 oder die Option „Aktuellen Standort anzeigen“ in Abbildung 2 dargestellt.
Es wird empfohlen, den Nutzerzugriff auf Funktionen zu deaktivieren, die Folgendes erfordern: Zugriff auf Standortermittlung im Hintergrund, bis die App eine Standortermittlung im Vordergrund hat Zugriff haben.
-
Später, wenn die Nutzenden Funktionen entdecken, die eine Standortzugriff im Hintergrund haben, können Sie Standort im Hintergrund anfordern Zugriff haben.
Bei Bedarf Standortermittlung im Hintergrund anfordern
Inhalt des Berechtigungsdialogfelds hängt von der SDK-Zielversion ab
Wenn eine Funktion Ihrer App auf einem ausgeführten Gerät die Standortermittlung im Hintergrund anfordert Unter Android 10 (API-Level 29) enthält das Dialogfeld für Systemberechtigungen eine Option namens Immer zulassen. Wenn der Nutzer diese Option auswählt, wird die Funktion in erhält Ihre App Zugriff auf die Standortermittlung im Hintergrund.
Unter Android 11 (API-Level 30) und höher wird das Systemdialogfeld Schließen Sie die Option Immer zulassen ein. Stattdessen müssen Nutzer die Hintergrundwiedergabe auf einer Einstellungsseite, wie in Abbildung 7 dargestellt.
Sie können Nutzern helfen, diese Einstellungsseite aufzurufen, indem Sie Best Practices befolgen wenn Sie die Berechtigung zur Standortermittlung im Hintergrund anfordern. Das Verfahren zur Gewährung des hängt von der SDK-Zielversion Ihrer App ab.
App ist auf Android 11 oder höher ausgerichtet
Wenn deiner App die Berechtigung „ACCESS_BACKGROUND_LOCATION
“ nicht gewährt wurde und
shouldShowRequestPermissionRationale()
true
zurückgibt, wird Nutzern eine pädagogische Benutzeroberfläche mit folgenden Elementen angezeigt:
- Eine klare Erklärung, warum die Funktion deiner App Zugriff auf den Hintergrund benötigt Standort.
- Das für den Nutzer sichtbare Label der Einstellungsoption, die die Standortermittlung im Hintergrund gewährt
(z. B. Immer zulassen in Abbildung 7). Sie können
getBackgroundPermissionOptionLabel()
um dieses Label zu erhalten. Der Rückgabewert dieser Methode ist Spracheinstellung des Geräts. - Option, mit der Nutzer die Berechtigung ablehnen können. Wenn Nutzer den Hintergrund ablehnen Standortzugriff haben, sollten sie deine App weiterhin verwenden können.
App ist auf Android 10 oder niedriger ausgerichtet
Wenn eine Funktion Ihrer App Zugriff auf die Standortermittlung im Hintergrund anfordert, sehen Nutzer eine Systemdialogfeld. Dieses Dialogfeld enthält eine Option, mit der du zum Standort der App wechseln kannst auf einer Einstellungsseite.
Solange Ihre App bereits den Best Practices für die Anforderung des Standorts entspricht müssen Sie keine Änderungen vornehmen, um dieses Verhalten zu unterstützen.
Nutzer kann die Genauigkeit der Standortermittlung im Hintergrund beeinträchtigen
Wenn der Nutzer den ungefähren Standort anfordert,
Die Einstellungen im Dialogfeld für die Berechtigungen zur Standortermittlung gelten auch für die Standortermittlung im Hintergrund. In
Wenn der Nutzer Ihrer App die Berechtigung „ACCESS_BACKGROUND_LOCATION
“ gewährt,
gewährt, aber im Vordergrund nur den ungefähren Standortzugriff gewährt,
-App auch im Hintergrund nur die ungefähre Standortermittlung verfügbar ist.
Erinnerung zur Gewährung der Standortermittlung im Hintergrund
Wenn eine Funktion Ihrer App unter Android 10 und höher auf den Gerätestandort zugreift, Hintergrund beim ersten Mal, nachdem der Nutzer die Standortermittlung im Hintergrund gewährt hat festgelegt wurde, plant das System eine Benachrichtigung, die an den Nutzer gesendet wird. Dieses Benachrichtigung erinnert den Nutzer daran, dass er deiner App den Zugriff auf das Gerät erlaubt hat immer auf den Standort zugreifen. In Abbildung 8 wird eine Beispielbenachrichtigung angezeigt.
Standortanforderungen in den SDK-Abhängigkeiten Ihrer App prüfen
Prüfen Sie, ob Ihre App SDKs verwendet, die von Berechtigungen zur Standortermittlung abhängen
insbesondere die Berechtigung ACCESS_FINE_LOCATION
. Lesen Sie diesen Artikel auf Medium
über das Verhalten Ihres SDK kennenlernen
Abhängigkeiten.
Weitere Informationen
Weitere Informationen zu Berechtigungen zur Standortermittlung in Android finden Sie hier: Materialien:
Codelabs
Videos
Produktproben
- Beispiel-App, um die Verwendung von Berechtigungen zur Standortermittlung zu demonstrieren