com.zdc.android.zms.maps

インタフェース LocationSource

public interface LocationSource

ZDCMapオブジェクトに位置情報を通知するためのインターフェース。

ZDCMapオブジェクトは、デフォルトでGPSから位置情報を取得する位置情報プロバイダを持っているが、 それをこのインターフェースを実装した別の位置情報プロバイダに置き換えることができる。

ZDCMapオブジェクトは、activate(OnLocationChangedListener)を使用して、位置情報プロバイダをアクティブにする。
位置情報プロバイダがアクティブの間（activate(OnLocationChangedListener) 〜 deactivate()の間）、activate(OnLocationChangedListener)で登録されたリスナーに定期的に位置情報の更新を通知する必要がある。

ネストされたクラスのサマリー

ネストされたクラス

修飾子とタイプ	インタフェースと説明
static interface	LocationSource.OnLocationChangedListener 位置情報が更新されたときのイベントリスナー

メソッドのサマリー

修飾子とタイプ	メソッドと説明
void	activate(LocationSource.OnLocationChangedListener listener) このロケーションプロバイダをアクティブにする。
void	deactivate() このプロバイダを無効にする。

メソッドの詳細

activate

void activate(LocationSource.OnLocationChangedListener listener)
       throws java.lang.IllegalStateException,
              java.lang.IllegalArgumentException

このロケーションプロバイダをアクティブにする。deactivate()が呼び出されるまで、定期的にlistenerに通知する。

パラメータ:

listener - 位置情報が更新されたときに呼び出されるリスナー

例外:

java.lang.IllegalStateException - activate済みの時

java.lang.IllegalArgumentException - listenerがnullの時

deactivate

void deactivate()
         throws java.lang.IllegalStateException

このプロバイダを無効にする。activate時に指定したlistenerに、位置情報が通知されなくなる。

例外:

java.lang.IllegalStateException - activateされていない時