Mit den Standort-APIs der Google Play-Dienste kann Ihre App den letzten bekannten Standort des Geräts des Nutzers anfordern. In den meisten Fällen ist der aktuelle Standort des Nutzers von Interesse, der in der Regel dem zuletzt bekannten Standort des Geräts entspricht.
Verwenden Sie insbesondere den Anbieter für kombinierte Standortbestimmung, um den letzten bekannten Standort des Geräts abzurufen. Der Anbieter für kombinierte Standortbestimmung ist eine der Standort-APIs in den Google Play-Diensten. Sie verwaltet die zugrunde liegende Standorttechnologie und bietet eine einfache API, mit der Sie Anforderungen auf hohem Niveau angeben können, z. B. hohe Genauigkeit oder geringer Stromverbrauch. Außerdem wird die Akkunutzung des Geräts optimiert.
Hinweis:Wenn deine App im Hintergrund ausgeführt wird, sollte der Zugriff auf den Standort für die Hauptfunktionen der App entscheidend sein und die Nutzer müssen entsprechend darüber informiert werden.
In dieser Lektion wird gezeigt, wie Sie mit der Methode getLastLocation() im Anbieter für kombinierte Standortbestimmung eine einzelne Anfrage für den Standort eines Geräts stellen.
Google Play-Dienste einrichten
Damit Sie auf den Anbieter für kombinierte Standortbestimmung zugreifen können, muss das Entwicklungsprojekt Ihrer App die Google Play-Dienste enthalten. Laden Sie die Google Play-Dienste-Komponente über den SDK-Manager herunter, installieren Sie sie und fügen Sie die Bibliothek Ihrem Projekt hinzu. Weitere Informationen finden Sie im Leitfaden zum Einrichten der Google Play-Dienste.
App-Berechtigungen festlegen
Apps, deren Funktionen standortbezogene Dienste verwenden, müssen je nach Anwendungsfall dieser Funktionen Berechtigungen zur Standortermittlung anfordern.
Client für standortbezogene Dienste erstellen
Erstellen Sie in der onCreate()-Methode Ihrer Aktivität eine Instanz des Anbieters für kombinierte Standortbestimmung, wie im folgenden Code-Snippet gezeigt.
Kotlin
private lateinit var fusedLocationClient: FusedLocationProviderClient override fun onCreate(savedInstanceState: Bundle?) { // ... fusedLocationClient = LocationServices.getFusedLocationProviderClient(this) }
Java
private FusedLocationProviderClient fusedLocationClient; // .. @Override protected void onCreate(Bundle savedInstanceState) { // ... fusedLocationClient = LocationServices.getFusedLocationProviderClient(this); }
Letzten bekannten Standort abrufen
Nachdem Sie den Standortdienste-Client erstellt haben, können Sie den letzten bekannten Standort des Geräts eines Nutzers abrufen. Wenn Ihre App mit diesen Diensten verbunden ist, können Sie die Methode getLastLocation() des Anbieters für kombinierte Standortbestimmung verwenden, um den Gerätestandort abzurufen. Die Genauigkeit des von diesem Aufruf zurückgegebenen Standorts wird durch die Berechtigungseinstellung bestimmt, die Sie in Ihrem App-Manifest festgelegt haben, wie im Leitfaden zum Anfordern von Berechtigungen zur Standortermittlung beschrieben.
Wenn Sie den letzten bekannten Standort abrufen möchten, rufen Sie die Methode getLastLocation() auf. Das folgende Code-Snippet zeigt die Anfrage und eine einfache Verarbeitung der Antwort:
Kotlin
fusedLocationClient.lastLocation .addOnSuccessListener { location : Location? -> // Got last known location. In some rare situations this can be null. }
Java
fusedLocationClient.getLastLocation() .addOnSuccessListener(this, new OnSuccessListener<Location>() { @Override public void onSuccess(Location location) { // Got last known location. In some rare situations this can be null. if (location != null) { // Logic to handle location object } } });
Die Methode getLastLocation() gibt ein Task zurück, mit dem Sie ein Location-Objekt mit den Längen- und Breitengradkoordinaten eines geografischen Standorts abrufen können. Das Standortobjekt kann in den folgenden Situationen null sein:
- Die Standortermittlung ist in den Geräteeinstellungen deaktiviert. Das Ergebnis könnte
nullsein, auch wenn der letzte Standort zuvor abgerufen wurde, da durch das Deaktivieren des Standorts auch der Cache geleert wird. - Das Gerät hat seinen Standort nie aufgezeichnet. Das kann bei einem neuen Gerät oder einem Gerät der Fall sein, das auf die Werkseinstellungen zurückgesetzt wurde.
- Die Google Play-Dienste auf dem Gerät wurden neu gestartet und es gibt keinen aktiven Client des Anbieters für kombinierte Standortbestimmung, der nach dem Neustart der Dienste den Standort angefordert hat. Um dies zu vermeiden, können Sie einen neuen Client erstellen und Standortaktualisierungen selbst anfordern. Weitere Informationen finden Sie unter Standortaktualisierungen anfordern.
Beste Standortschätzung auswählen
Der FusedLocationProviderClient bietet mehrere Methoden zum Abrufen von Standortinformationen des Geräts. Wählen Sie je nach Anwendungsfall Ihrer App eine der folgenden Optionen aus:
getLastLocation()erhält schneller eine Standortschätzung und minimiert den Akkuverbrauch, der auf Ihre App zurückzuführen ist. Die Standortinformationen sind jedoch möglicherweise veraltet, wenn in letzter Zeit keine anderen Clients den Standort aktiv verwendet haben.getCurrentLocation()erhält regelmäßig einen aktuelleren und genaueren Standort. Diese Methode kann jedoch dazu führen, dass die aktive Standortberechnung auf dem Gerät erfolgt.Dies ist die empfohlene Methode, um nach Möglichkeit einen aktuellen Standort abzurufen. Sie ist sicherer als Alternativen wie das Starten und Verwalten von Standortaktualisierungen mit
requestLocationUpdates(). Wenn Ihre ApprequestLocationUpdates()aufruft, kann sie manchmal große Mengen an Energie verbrauchen, wenn der Standort nicht verfügbar ist oder die Anfrage nach dem Abrufen eines neuen Standorts nicht korrekt beendet wird.
Zusätzliche Ressourcen
Weitere Informationen zum Abrufen des aktuellen Standorts unter Android finden Sie in den folgenden Materialien:
Beispiele
- Beispiel-App, die Best Practices beim Abrufen des aktuellen Standorts veranschaulicht