Android中文API（131） —— GpsStatus

前言

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

 

聲明

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

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

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

 

 

 

GpsStatus

譯者署名：熊貓82

譯者連結：http://wisekingokok.cnblogs.com

版本：Android 3.2 r1

 

結構

繼承關係

public final class GpsStatus extends Object

        

java.lang.Object

android.location.GpsStatus

 

類概述

此類用於表述GPS引擎的目前狀態，此類需要和GpsStatus.Listener介面結合使用。

 

常量

int  GPS_EVENT_FIRST_FIX

當GPS系統模組接收到第一次GPS定位資訊之後發送此事件碼。調用getTimeToFirstFix()方法擷取自GPS系統模組被開啟至第一次定位所消耗的時間。

常量值：3(0x00000003)

        

int  GPS_EVENT_SATELLITE_STATUS

周期性發送GPS衛星狀態的事件碼。調用getSatellites()方法擷取每一顆定位衛星的各種狀態。（譯者註：此事件碼需在擷取到衛星狀態之後，才會發送。在沒有搜尋到衛星的時候，不會發送此事件碼。）

常量值：4 (0x00000004)

        

int  GPS_EVENT_STARTED

當GPS系統模組被開啟之後發送此事件碼。

常量值：1 (0x00000001)

 

int  GPS_EVENT_STOPPED

當GPS系統模組被關閉之後發送此事件碼。

常量值：2 (0x00000002)

 

內部類

　　interface          GpsStatus.Listener       

　　用於接收當GPS狀態發生改變時所發出的通知

 

　　interface          GpsStatus.NmeaListener      

　　用於從GPS接收NMEA資訊。

 

公用方法

public int getMaxSatellites ()

返回通過getSatellites()方法返回的衛星列表的最大衛星數。

                   傳回值

                            最大衛星數。

 

public Iterable<GpsSatellite> getSatellites ()

返回一組用於描述GPS引擎目前狀態的衛星對象。

                   傳回值

                   一組衛星對象。

 

public int getTimeToFirstFix ()

返回自GPS引擎最新啟動以來至收到的首次定位所需的時間。

                   傳回值

                            首次定位所需的時間

 

補充

         文章精選

                   百度百科 GPS

                   Android定位功能（一）

                   Android定位功能（二）

 

GpsStatus.Listener

譯者署名：熊貓82

譯者連結：http://wisekingokok.cnblogs.com

版本：Android 3.2 r1

 

結構

繼承關係

public static interface GpsStatus.Listener

        

android.location.GpsStatus.Listener

 

類概述

用於接收當GPS狀態發生改變時所發出的通知。

 

公用方法

public abstract void onGpsStatusChanged (int event)

         當GPS狀態發生改變時會回調此方法。GPS狀態改變時會發出下列四個事件碼的其中一個：

*   GPS_EVENT_STARTED

*   GPS_EVENT_STOPPED

*   GPS_EVENT_FIRST_FIX

*   GPS_EVENT_SATELLITE_STATUS

可以在方法內部調用getGpsStatus(Gpsstatus)擷取GPS狀態資訊。      

參數

                            event        GPS狀態發生改變時的事件碼.

 

 

GpsStatus.NmeaListener

譯者署名：熊貓82

譯者連結：http://wisekingokok.cnblogs.com

版本：Android 3.2 r1

 

結構

繼承關係

public static interface GpsStatus.NmeaListener

        

android.location.GpsStatus.NmeaListener

 

類概述

用於從GPS中擷取NMEA資訊。NMEA 0183是一個與海洋電子裝置進行通訊的標準，通過一系列介面接收來自GPS的資料，是一種常見的方法。更多細節見NMEA0183。您可以實現這個介面，並調用addNmeaListener（GpsStatus.NmeaListener）從GPS引擎接收NMEA資料的。 （譯者註：這裡NMEA-0183協議為通常所說的GPS協議，參見這裡。）

 

公用方法

public abstract void onNmeaReceived (long timestamp, String nmea)

（譯者註：原文無說明。這個介面的此方法貌似是預留的一種規範，曾跟蹤源碼，發現在硬體訪問層補充nmea_callback的代碼，才能將資料傳到應用上層

參數

                            timestamp      時間戳記，單位為毫秒。

                            nmea                 nmea資訊。

         ）