Most visited

Recently visited

Added in API level 24

GnssNavigationMessage

public final class GnssNavigationMessage
extends Object implements Parcelable

java.lang.Object
   ↳ android.location.GnssNavigationMessage


包含GNSS卫星导航消息的类。

Summary

Nested classes

class GnssNavigationMessage.Callback

用于从GNSS引擎接收GNSS卫星导航信息。

Constants

int STATUS_PARITY_PASSED

导航消息在导航字中没有任何奇偶校验错误时收到。

int STATUS_PARITY_REBUILT

接收到的导航消息中包含奇偶校验失败的单词,但接收方能够纠正这些单词。

int STATUS_UNKNOWN

导航消息状态是“未知”。

int TYPE_BDS_D1

北斗D1消息中包含的结构。

int TYPE_BDS_D2

北斗D2消息中包含的结构。

int TYPE_GAL_F

伽利略F / NAV消息包含在结构中。

int TYPE_GAL_I

伽利略I / NAV消息包含在结构中。

int TYPE_GLO_L1CA

结构中包含Glonass L1 CA消息。

int TYPE_GPS_CNAV2

包含在结构中的GPS CNAV-2消息。

int TYPE_GPS_L1CA

GPS L1 C / A消息包含在结构中。

int TYPE_GPS_L2CNAV

包含在结构中的GPS L2-CNAV消息。

int TYPE_GPS_L5CNAV

包含在结构中的GPS L5-CNAV消息。

int TYPE_UNKNOWN

消息类型未知

Inherited constants

From interface android.os.Parcelable

Fields

public static final Creator<GnssNavigationMessage> CREATOR

Public methods

int describeContents()

描述此Parcelable实例的封送表示中包含的特殊对象的种类。

byte[] getData()

获取所报告的GPS消息的数据。

int getMessageId()

获取消息标识符。

int getStatus()

获取对象中包含的导航消息的状态。

int getSubmessageId()

获取与消息的 getType()相关的子消息标识符。

int getSvid()

获取卫星ID。

int getType()

获取对象中包含的导航消息的类型。

String toString()

返回对象的字符串表示形式。

void writeToParcel(Parcel parcel, int flags)

将此对象平铺到一个包裹中。

Inherited methods

From class java.lang.Object
From interface android.os.Parcelable

Constants

STATUS_PARITY_PASSED

Added in API level 24
int STATUS_PARITY_PASSED

导航消息在导航字中没有任何奇偶校验错误时收到。

常数值:1(0x00000001)

STATUS_PARITY_REBUILT

Added in API level 24
int STATUS_PARITY_REBUILT

接收到的导航消息中包含奇偶校验失败的单词,但接收方能够纠正这些单词。

常量值:2(0x00000002)

STATUS_UNKNOWN

Added in API level 24
int STATUS_UNKNOWN

导航消息状态是“未知”。

常量值:0(0x00000000)

TYPE_BDS_D1

Added in API level 24
int TYPE_BDS_D1

北斗D1消息中包含的结构。

常量值:1281(0x00000501)

TYPE_BDS_D2

Added in API level 24
int TYPE_BDS_D2

北斗D2消息中包含的结构。

常量值:1282(0x00000502)

TYPE_GAL_F

Added in API level 24
int TYPE_GAL_F

伽利略F / NAV消息包含在结构中。

常量值:1538(0x00000602)

TYPE_GAL_I

Added in API level 24
int TYPE_GAL_I

伽利略I / NAV消息包含在结构中。

常量值:1537(0x00000601)

TYPE_GLO_L1CA

Added in API level 24
int TYPE_GLO_L1CA

结构中包含Glonass L1 CA消息。

常量值:769(0x00000301)

TYPE_GPS_CNAV2

Added in API level 24
int TYPE_GPS_CNAV2

包含在结构中的GPS CNAV-2消息。

常量值:260(0x00000104)

TYPE_GPS_L1CA

Added in API level 24
int TYPE_GPS_L1CA

GPS L1 C / A消息包含在结构中。

常量值:257(0x00000101)

TYPE_GPS_L2CNAV

Added in API level 24
int TYPE_GPS_L2CNAV

包含在结构中的GPS L2-CNAV消息。

常量值:258(0x00000102)

TYPE_GPS_L5CNAV

Added in API level 24
int TYPE_GPS_L5CNAV

包含在结构中的GPS L5-CNAV消息。

常量值:259(0x00000103)

TYPE_UNKNOWN

Added in API level 24
int TYPE_UNKNOWN

消息类型未知

常量值:0(0x00000000)

Fields

CREATOR

Added in API level 24
Creator<GnssNavigationMessage> CREATOR

Public methods

describeContents

Added in API level 24
int describeContents ()

描述此Parcelable实例的封送表示中包含的特殊对象的种类。 例如,如果对象将在writeToParcel(Parcel, int)的输出中包含writeToParcel(Parcel, int) ,则此方法的返回值必须包含CONTENTS_FILE_DESCRIPTOR位。

Returns
int a bitmask indicating the set of special object types marshaled by this Parcelable object instance.

getData

Added in API level 24
byte[] getData ()

获取所报告的GPS消息的数据。

使用大端格式(MSB优先)指定的字节(或字)。

  • For GPS L1 C/A, Beidou D1 & Beidou D2, each subframe contains 10 30-bit words. Each word (30 bits) should be fit into the last 30 bits in a 4-byte word (skip B31 and B32), with MSB first, for a total of 40 bytes, covering a time period of 6, 6, and 0.6 seconds, respectively.
  • For Glonass L1 C/A, each string contains 85 data bits, including the checksum. These bits should be fit into 11 bytes, with MSB first (skip B86-B88), covering a time period of 2 seconds.
  • For Galileo F/NAV, each word consists of 238-bit (sync & tail symbols excluded). Each word should be fit into 30-bytes, with MSB first (skip B239, B240), covering a time period of 10 seconds.
  • For Galileo I/NAV, each page contains 2 page parts, even and odd, with a total of 2x114 = 228 bits, (sync & tail excluded) that should be fit into 29 bytes, with MSB first (skip B229-B232).

Returns
byte[]

getMessageId

Added in API level 24
int getMessageId ()

获取消息标识符。

这提供了一个索引来帮助完成导航消息组装。 数据位本身中的类似标识符通常以更具体的每种消息类型的方式补充该信息; 有关详细信息,请参阅相关卫星星座ICD。

  • For GPS L1 C/A subframe 4 and 5, this value corresponds to the 'frame id' of the navigation message, in the range of 1-25 (Subframe 1, 2, 3 does not contain a 'frame id' and this value can be set to -1.)
  • For Glonass L1 C/A, this refers to the frame ID, in the range of 1-5.
  • For BeiDou D1, this refers to the frame number in the range of 1-24
  • For Beidou D2, this refers to the frame number, in the range of 1-120
  • For Galileo F/NAV nominal frame structure, this refers to the subframe number, in the range of 1-12
  • For Galileo I/NAV nominal frame structure, this refers to the subframe number in the range of 1-24

Returns
int

getStatus

Added in API level 24
int getStatus ()

获取对象中包含的导航消息的状态。

Returns
int

getSubmessageId

Added in API level 24
int getSubmessageId ()

获取与消息的 getType()相关的子消息标识符。

  • For GPS L1 C/A, BeiDou D1 & BeiDou D2, the submessage id corresponds to the subframe number of the navigation message, in the range of 1-5.
  • For Glonass L1 C/A, this refers to the String number, in the range from 1-15
  • For Galileo F/NAV, this refers to the page type in the range 1-6
  • For Galileo I/NAV, this refers to the word type in the range 1-10+
  • For Galileo in particular, the type information embedded within the data bits may be even more useful in interpretation, than the nominal page and word types provided in this field.

Returns
int

getSvid

Added in API level 24
int getSvid ()

获取卫星ID。

范围因星座而异。 请参阅GnssStatus#getSvid(int)定义

Returns
int

getType

Added in API level 24
int getType ()

获取对象中包含的导航消息的类型。

Returns
int

toString

Added in API level 24
String toString ()

返回对象的字符串表示形式。 一般来说, toString方法返回一个“文本表示”该对象的字符串。 结果应该是一个简洁但内容丰富的表述,对于一个人来说很容易阅读。 建议所有子类重写此方法。

ObjecttoString方法返回一个字符串,其中包含对象为实例的类的名称,符号字符“ @ ”和对象的哈希代码的无符号十六进制表示形式。 换句话说,这个方法返回一个字符串,其值等于:

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

Returns
String a string representation of the object.

writeToParcel

Added in API level 24
void writeToParcel (Parcel parcel, 
                int flags)

将此对象平铺到一个包裹中。

Parameters
parcel Parcel: The Parcel in which the object should be written.
flags int: Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE.

Hooray!