Android中文API（133） —— LocationListener

 

前言

　　本章內容是android.location.LocationListener，為GPS相關章節，版本為Android 3.2 r1，翻譯來自"熊貓82"，歡迎訪問他的部落格："http://wisekingokok.cnblogs.com"，再次感謝"熊貓82"！歡迎你一起參與Android的中文翻譯，聯絡我over140@gmail.com。 

 

聲明

　　歡迎轉載，但請保留文章原始出處:) 

　　　　部落格園：http://www.cnblogs.com/

　　　　Android中文翻譯組：http://goo.gl/6vJQl

 

 

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都需要提供的值。•定位衛星 – 一組用於裝置定位的衛星