Android中文API（131） —— GpsStatus

前言

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

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_FI

*   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信息。

         ）