Definiert eine Schnittstelle zur Bereitstellung von Standortdaten, normalerweise für ein GoogleMap-Objekt.
Ein GoogleMap-Objekt hat einen integrierten Standortanbieter für die Ebene „Mein Standort“. Es kann aber auch replaced sein, zusammen mit einem anderen, der diese Schnittstelle implementiert.
Ein GoogleMap-Objekt aktiviert seinen Standortanbieter mithilfe von activate(OnLocationChangedListener). Wenn er aktiv ist (zwischen activate(OnLocationChangedListener) und deactivate()), sollte ein Standortanbieter regelmäßig Standortaktualisierungen an den in activate(OnLocationChangedListener) registrierten Listener senden. Es liegt in der Verantwortung des Anbieters, Standortdienste je nach Lebenszyklusstatus der Karte mit Bedacht zu nutzen. Zum Beispiel sollte es nur gelegentlich mit batterieintensiven Diensten wie GPS verwendet werden oder nur, wenn eine Aktivität im Vordergrund ausgeführt wird.
Nested Class Summary
| benutzeroberfläche | LocationSource.OnLocationChangedListener | Verarbeitet ein Standortupdate. | |
Public Method Summary
| Abstrakt void | |
| Abstrakt void |
deactivate()
Deaktiviert diesen Anbieter.
|
Public Methods
Public abstrakt void aktivieren (LocationSource.OnLocationChangedListener-Listener)
Aktiviert diesen Anbieter. Dieser Anbieter benachrichtigt den angegebenen Listener in regelmäßigen Abständen, bis Sie deactivate() aufrufen. Benachrichtigungen werden im Hauptthread gesendet.
Parameter
| Listener | Listener, der aufgerufen wird, wenn ein neuer Standort verfügbar ist |
|---|
Throws
| IllegalStateException | wenn dieser Anbieter bereits aktiv ist |
|---|---|
| IllegalArgumentException | wenn listener null ist
|
öffentlich abstrakt void deaktivieren ()
Deaktiviert diesen Anbieter. Der zuvor registrierte Callback wird nicht benachrichtigt.
Throws
| IllegalStateException | wenn dieser Anbieter bereits inaktiv ist |
|---|