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

         ）