Android中文API（133） —— LocationListener

前言

　　本章內容是android.location.LocationListener，為GPS相關章節，版本為Android 3.2 r1，翻譯來自"熊貓82"。 

LocationListener

譯者署名：熊貓82

譯者鏈接：http://wisekingokok.cnblogs.com

版本：Android 3.2 r1

結構

繼承關系

public interface LocationListener

android.location.LocationListener

類概述

用於接收從LocationManager的位置發生改變時的通知。如果LocationListener被注冊添加到LocationManager對象，並且此LocationManager對象調用了requestLocationUpdates(String, long, float, LocationListener)方法，那麼接口中的相關方法將會被調用

公共方法

public abstract void onLocationChanged (Location location)

      此方法在當位置發生改變後被調用。這裡可以沒有限制的使用Location對象。

參數

                            位置發生變化後的新位置。

public abstract void onProviderDisabled(String provider)

      此方法在provider被用戶關閉後被調用，如果基於一個已經關閉了的provider調用requestLocationUpdates方法被調用，那麼這個方法理解被調用。

參數

與之關聯的location provider名稱。

public abstract void onPorviderEnabled (Location location)

      此方法在provider被用戶開啟後調用。

參數

                            provider  與之關聯的location provider名稱。

public abstract void onStatusChanged (String provider, int Status, Bundle extras)

      此方法在Provider的狀態在可用、暫時不可用和無服務三個狀態直接切換時被調用。

參數

provider   與變化相關的location provider名稱。

status     如果服務已停止，並且在短時間內不會改變，狀態碼為OUT_OF_SERVICE；如果服務暫時停止，並且在短時間內會恢復，狀態碼為TEMPORARILY_UNAVAILABLE；如果服務正常有效，狀態碼為AVAILABLE。

extras     一組可選參數，其包含provider的特定狀態。下面列出一組共用的鍵值對，其實任何鍵的provider都需要提供的值。•定位衛星 – 一組用於設備定位的衛星