LocationSource

公用介面 LocationSource

定義用於提供位置資料的介面 (通常為 GoogleMap 物件)。

GoogleMap 物件具有「我的位置」圖層的內建位置供應器,但可以是另一個實作此介面的 replaced

GoogleMap 物件會使用 activate(OnLocationChangedListener) 啟用其位置提供者。啟用時 (介於 activate(OnLocationChangedListener)deactivate() 之間),位置提供者應定期將位置更新推送至 activate(OnLocationChangedListener) 中註冊的事件監聽器。供應商必須根據地圖的生命週期狀態,謹慎使用定位服務。舉例來說,有時只有在活動於前景運作時,才會使用耗電服務 (例如 GPS)。

巢狀類別摘要

LocationSource.OnLocationChangedListener 處理位置更新作業。

公用方法摘要

抽象 void
activate(LocationSource.OnLocationChangedListener事件監聽器)
啟用這個提供者。
抽象 void
deactivate()
停用這個供應商。

公用方法

公用抽象 void activate (LocationSource.OnLocationChangedListener事件監聽器)

啟用這個提供者。這個提供者會定期通知提供的事件監聽器,直到您呼叫 deactivate() 為止。通知會在主執行緒上播送。

參數
事件監聽器 有新位置時呼叫的事件監聽器
擲回
IllegalStateException 如果這個供應商已啟用
IllegalArgumentException 如果 listenernull

public abs void deactivate ()

停用這個供應商。先前已註冊的回呼不會收到進一步更新的通知。

擲回
IllegalStateException 如果這個供應商已經停用