公用介面 LocationSource
定義用於提供位置資料的介面 (通常為 GoogleMap 物件)。
GoogleMap 物件具有「我的位置」圖層的內建位置供應器，但可以是另一個實作此介面的 replaced。
GoogleMap 物件會使用 activate(OnLocationChangedListener) 啟用其位置提供者。啟用時 (介於 activate(OnLocationChangedListener) 和 deactivate() 之間)，位置提供者應定期將位置更新推送至 activate(OnLocationChangedListener) 中註冊的事件監聽器。供應商必須根據地圖的生命週期狀態，謹慎使用定位服務。舉例來說，有時只有在活動於前景運作時，才會使用耗電服務 (例如 GPS)。
巢狀類別摘要
| LocationSource.OnLocationChangedListener | 處理位置更新作業。 | ||
公用方法摘要
| 抽象 void | |
| 抽象 void |
deactivate()
停用這個供應商。
|
公用方法
公用抽象 void activate (LocationSource.OnLocationChangedListener事件監聽器)
啟用這個提供者。這個提供者會定期通知提供的事件監聽器，直到您呼叫 deactivate() 為止。通知會在主執行緒上播送。
參數
| 事件監聽器 | 有新位置時呼叫的事件監聽器 |
|---|
擲回
| IllegalStateException | 如果這個供應商已啟用 |
|---|---|
| IllegalArgumentException | 如果 listener 為 null
|
public abs void deactivate ()
停用這個供應商。先前已註冊的回呼不會收到進一步更新的通知。
擲回
| IllegalStateException | 如果這個供應商已經停用 |
|---|