Die angemessene Verwendung von Standortinformationen kann für die Nutzer deiner App von Vorteil sein. Wenn deine App dem Nutzer beispielsweise hilft, sich beim Gehen oder Fahren zurechtzufinden, oder wenn sie den Standort von Assets verfolgt, muss sie in regelmäßigen Abständen den Standort des Geräts abrufen. Neben dem geografischen Standort (Breiten- und Längengrad) können Sie dem Nutzer weitere Informationen wie die Peilung (horizontale Bewegungsrichtung), die Höhe oder die Geschwindigkeit des Geräts zur Verfügung stellen. Diese und weitere Informationen sind im Location-Objekt verfügbar, das deine App vom Fused Location Provider abrufen kann. Die API aktualisiert Ihre App dann regelmäßig mit dem besten verfügbaren Standort, basierend auf den derzeit verfügbaren Standortanbietern wie WLAN und GPS (Global Positioning System). Die Genauigkeit des Standorts wird durch die Anbieter, die von Ihnen angeforderten Berechtigungen zur Standortermittlung und die Optionen bestimmt, die Sie in der Standortanfrage festgelegt haben.
In dieser Lektion erfahren Sie, wie Sie mit der Methode requestLocationUpdates() im Fused Location Provider regelmäßige Updates zum Standort eines Geräts anfordern.
Letzten bekannten Standort abrufen
Der zuletzt bekannte Standort des Geräts ist ein guter Ausgangspunkt, um sicherzustellen, dass die App einen bekannten Standort hat, bevor die regelmäßigen Standort-Updates gestartet werden. In der Lektion Letzten bekannten Standort abrufen wird gezeigt, wie Sie den letzten bekannten Standort durch Aufrufen von getLastLocation() abrufen.
In den Snippets in den folgenden Abschnitten wird davon ausgegangen, dass Ihre App den letzten bekannten Standort bereits abgerufen und als Location-Objekt in der globalen Variable mCurrentLocation gespeichert hat.
Standortabfrage senden
Bevor deine App Standort-Updates anfordern kann, muss sie eine Verbindung zu den Standortdiensten herstellen und eine Standortanfrage senden. In der Lektion Standorteinstellungen ändern wird gezeigt, wie das geht. Sobald eine Standortanfrage vorhanden ist, können Sie die regelmäßigen Aktualisierungen starten, indem Sie requestLocationUpdates() aufrufen.
Je nach Form der Anfrage ruft der Fused Location Provider entweder die Callback-Methode LocationCallback.onLocationResult() auf und übergibt ihr eine Liste von Location-Objekten oder gibt einen PendingIntent aus, der den Standort in seinen erweiterten Daten enthält. Die Genauigkeit und Häufigkeit der Aktualisierungen hängen von den angeforderten Berechtigungen zur Standortermittlung und den Optionen ab, die Sie im Objekt für die Standortanfrage festgelegt haben.
In dieser Lektion wird gezeigt, wie Sie das Update mithilfe des Callback-Ansatzes LocationCallback abrufen. Rufen Sie requestLocationUpdates() auf und übergeben Sie die Instanz des LocationRequest-Objekts und ein LocationCallback.
Definieren Sie eine startLocationUpdates()-Methode, wie im folgenden Codebeispiel gezeigt:
Kotlin
override fun onResume() {
super.onResume()
if (requestingLocationUpdates) startLocationUpdates()
}
private fun startLocationUpdates() {
fusedLocationClient.requestLocationUpdates(locationRequest,
locationCallback,
Looper.getMainLooper())
}
Java
@Override
protected void onResume() {
super.onResume();
if (requestingLocationUpdates) {
startLocationUpdates();
}
}
private void startLocationUpdates() {
fusedLocationClient.requestLocationUpdates(locationRequest,
locationCallback,
Looper.getMainLooper());
}
Im obigen Code-Snippet wird das boolesche Flag requestingLocationUpdates verwendet, um zu prüfen, ob der Nutzer Standort-Updates aktiviert oder deaktiviert hat. Wenn Nutzer Standort-Updates deaktiviert haben, können Sie sie über die Standortanforderungen Ihrer App informieren. Weitere Informationen zum Beibehalten des Werts des booleschen Flags über Instanzen der Aktivität hinweg finden Sie unter Aktivitätsstatus speichern.
Callback für Standortaktualisierung definieren
Der Fused Location Provider ruft die Callback-Methode LocationCallback.onLocationResult() auf. Das eingehende Argument enthält ein Listenobjekt Location mit dem Breiten- und Längengrad des Standorts. Das folgende Snippet zeigt, wie Sie die Schnittstelle LocationCallback implementieren und die Methode definieren, dann den Zeitstempel des Standort-Updates abrufen und den Breiten- und Längengrad sowie den Zeitstempel auf der Benutzeroberfläche Ihrer App anzeigen:
Kotlin
private lateinit var locationCallback: LocationCallback
// ...
override fun onCreate(savedInstanceState: Bundle?) {
// ...
locationCallback = object : LocationCallback() {
override fun onLocationResult(locationResult: LocationResult?) {
locationResult ?: return
for (location in locationResult.locations){
// Update UI with location data
// ...
}
}
}
}
Java
private LocationCallback locationCallback;
// ...
@Override
protected void onCreate(Bundle savedInstanceState) {
// ...
locationCallback = new LocationCallback() {
@Override
public void onLocationResult(LocationResult locationResult) {
if (locationResult == null) {
return;
}
for (Location location : locationResult.getLocations()) {
// Update UI with location data
// ...
}
}
};
}
Standortaktualisierungen beenden
Überlegen Sie, ob Sie die Standort-Updates beenden möchten, wenn die Aktivität nicht mehr im Fokus ist, z. B. wenn der Nutzer zu einer anderen App oder zu einer anderen Aktivität in derselben App wechselt. So lässt sich der Stromverbrauch senken, sofern die App keine Informationen erfassen muss, wenn sie im Hintergrund ausgeführt wird. In diesem Abschnitt wird gezeigt, wie Sie die Aktualisierungen in der Methode onPause() der Aktivität beenden können.
Wenn Sie die Standortaktualisierungen beenden möchten, rufen Sie removeLocationUpdates() auf und übergeben Sie LocationCallback, wie im folgenden Codebeispiel gezeigt:
Kotlin
override fun onPause() {
super.onPause()
stopLocationUpdates()
}
private fun stopLocationUpdates() {
fusedLocationClient.removeLocationUpdates(locationCallback)
}
Java
@Override
protected void onPause() {
super.onPause();
stopLocationUpdates();
}
private void stopLocationUpdates() {
fusedLocationClient.removeLocationUpdates(locationCallback);
}
Verwenden Sie den booleschen Wert requestingLocationUpdates, um zu verfolgen, ob Standortaktualisierungen derzeit aktiviert sind. Prüfen Sie in der onResume()-Methode der Aktivität, ob Standortupdates derzeit aktiv sind, und aktivieren Sie sie, falls nicht:
Kotlin
override fun onResume() {
super.onResume()
if (requestingLocationUpdates) startLocationUpdates()
}
Java
@Override
protected void onResume() {
super.onResume();
if (requestingLocationUpdates) {
startLocationUpdates();
}
}
Status der Aktivität speichern
Eine Änderung der Gerätekonfiguration, z. B. eine Änderung der Bildschirmausrichtung oder der Sprache, kann dazu führen, dass die aktuelle Aktivität gelöscht wird. Deine App muss daher alle Informationen speichern, die sie zum Neuerstellen der Aktivität benötigt.
Eine Möglichkeit hierfür ist die Verwendung eines Instanzstatus, der in einem Bundle-Objekt gespeichert ist.
Im folgenden Codebeispiel wird gezeigt, wie Sie den Callback onSaveInstanceState() der Aktivität verwenden, um den Instanzstatus zu speichern:
Kotlin
override fun onSaveInstanceState(outState: Bundle?) {
outState?.putBoolean(REQUESTING_LOCATION_UPDATES_KEY, requestingLocationUpdates)
super.onSaveInstanceState(outState)
}
Java
@Override
protected void onSaveInstanceState(Bundle outState) {
outState.putBoolean(REQUESTING_LOCATION_UPDATES_KEY,
requestingLocationUpdates);
// ...
super.onSaveInstanceState(outState);
}
Definiere eine updateValuesFromBundle()-Methode, um die gespeicherten Werte aus der vorherigen Instanz der Aktivität wiederherzustellen, falls sie verfügbar sind. Rufen Sie die Methode über die Methode onCreate() der Aktivität auf, wie im folgenden Codebeispiel gezeigt:
Kotlin
override fun onCreate(savedInstanceState: Bundle?) {
// ...
updateValuesFromBundle(savedInstanceState)
}
private fun updateValuesFromBundle(savedInstanceState: Bundle?) {
savedInstanceState ?: return
// Update the value of requestingLocationUpdates from the Bundle.
if (savedInstanceState.keySet().contains(REQUESTING_LOCATION_UPDATES_KEY)) {
requestingLocationUpdates = savedInstanceState.getBoolean(
REQUESTING_LOCATION_UPDATES_KEY)
}
// ...
// Update UI to match restored state
updateUI()
}
Java
@Override
public void onCreate(Bundle savedInstanceState) {
// ...
updateValuesFromBundle(savedInstanceState);
}
private void updateValuesFromBundle(Bundle savedInstanceState) {
if (savedInstanceState == null) {
return;
}
// Update the value of requestingLocationUpdates from the Bundle.
if (savedInstanceState.keySet().contains(REQUESTING_LOCATION_UPDATES_KEY)) {
requestingLocationUpdates = savedInstanceState.getBoolean(
REQUESTING_LOCATION_UPDATES_KEY);
}
// ...
// Update UI to match restored state
updateUI();
}
Weitere Informationen zum Speichern des Instanzstatus findest du in der Referenz zur Android-Klasse „Activity“.
Zusätzliche Ressourcen
Weitere Informationen finden Sie in den folgenden Ressourcen:
Beispiele
- Beispiel-App, die zeigt, wie Standort-Updates in Android empfangen werden.