位置情報(通常は GoogleMap
オブジェクト)を提供するためのインターフェースを定義します。
GoogleMap
オブジェクトには現在地レイヤの組み込みの位置情報プロバイダがありますが、このインターフェースを実装する別のプロバイダと一緒に replaced
にすることもできます。
GoogleMap
オブジェクトは、activate(OnLocationChangedListener)
を使用して位置情報プロバイダを有効にします。位置情報がアクティブ(activate(OnLocationChangedListener)
~deactivate()
)の間、位置情報プロバイダは activate(OnLocationChangedListener)
に登録されているリスナーに位置情報の更新を定期的にプッシュする必要があります。地図のライフサイクルの状態に応じて、位置情報サービスを適切に使用するのはプロバイダの責任です。たとえば、バッテリー消費量の多いサービス(GPS など)は、ときどき、またはアクティビティがフォアグラウンドにある場合にのみ使用するようにしてください。
ネストクラスの概要
インターフェース | LocationSource.OnLocationChangedListener | 位置情報の更新を処理する。 |
パブリック メソッドの概要
抽象 void | |
抽象 void |
deactivate()
このプロバイダを無効にします。
|
パブリック メソッド
public 抽象 void activate (LocationSource.OnLocationChangedListener リスナー)
このプロバイダを有効にします。このプロバイダは、deactivate()
を呼び出すまで、指定されたリスナーに定期的に通知します。通知はメインスレッドにブロードキャストされます。
パラメータ
リスナー | 新しい位置情報が利用可能になったときに呼び出されるリスナー |
---|
例外
IllegalStateException | このプロバイダがすでにアクティブである場合 |
---|---|
IllegalArgumentException | listener が null の場合
|
public act void deactivate ()
このプロバイダを無効にします。以前に登録したコールバックには、今後の更新が通知されません。
例外
IllegalStateException | すでに無効になっている場合、 |
---|