GnssNavigationMessage
class GnssNavigationMessage : Parcelable
kotlin.Any | |
↳ | android.location.GnssNavigationMessage |
A class containing a GNSS satellite Navigation Message.
Summary
Nested classes | |
---|---|
abstract |
Used for receiving GNSS satellite Navigation Messages from the GNSS engine. |
Constants | |
---|---|
static Int |
The Navigation Message was received without any parity error in its navigation words. |
static Int |
The Navigation Message was received with words that failed parity check, but the receiver was able to correct those words. |
static Int |
The Navigation Message Status is 'unknown'. |
static Int |
Beidou CNAV1 message contained in the structure. |
static Int |
Beidou CNAV2 message contained in the structure. |
static Int |
Beidou D1 message contained in the structure. |
static Int |
Beidou D2 message contained in the structure. |
static Int |
Galileo F/NAV message contained in the structure. |
static Int |
Galileo I/NAV message contained in the structure. |
static Int |
Glonass L1 CA message contained in the structure. |
static Int |
GPS CNAV-2 message contained in the structure. |
static Int |
GPS L1 C/A message contained in the structure. |
static Int |
GPS L2-CNAV message contained in the structure. |
static Int |
GPS L5-CNAV message contained in the structure. |
static Int |
NavIC L1 message contained in the structure. |
static Int |
NavIC L5 message contained in the structure. |
static Int |
NavIC L5 C/A message contained in the structure. |
static Int |
QZSS L1 C/A message contained in the structure. |
static Int |
SBAS message contained in the structure. |
static Int |
Message type unknown |
Inherited constants | |
---|---|
Public methods | |
---|---|
Int | |
ByteArray |
getData() Gets the data of the reported GNSS message. |
Int |
Gets the Message identifier. |
Int |
Gets the Status of the navigation message contained in the object. |
Int |
Gets the sub-message identifier, relevant to the |
Int |
getSvid() Gets the satellite ID. |
Int |
getType() Gets the type of the navigation message contained in the object. |
String |
toString() |
Unit |
writeToParcel(: Parcel, : Int) |
Properties | |
---|---|
static Parcelable.Creator<GnssNavigationMessage!> |
Constants
STATUS_PARITY_PASSED
static val STATUS_PARITY_PASSED: Int
The Navigation Message was received without any parity error in its navigation words.
Value: 1
STATUS_PARITY_REBUILT
static val STATUS_PARITY_REBUILT: Int
The Navigation Message was received with words that failed parity check, but the receiver was able to correct those words.
Value: 2
STATUS_UNKNOWN
static val STATUS_UNKNOWN: Int
The Navigation Message Status is 'unknown'.
Value: 0
TYPE_BDS_CNAV1
static val TYPE_BDS_CNAV1: Int
Beidou CNAV1 message contained in the structure.
Value: 1283
TYPE_BDS_CNAV2
static val TYPE_BDS_CNAV2: Int
Beidou CNAV2 message contained in the structure.
Value: 1284
TYPE_BDS_D1
static val TYPE_BDS_D1: Int
Beidou D1 message contained in the structure.
Value: 1281
TYPE_BDS_D2
static val TYPE_BDS_D2: Int
Beidou D2 message contained in the structure.
Value: 1282
TYPE_GAL_F
static val TYPE_GAL_F: Int
Galileo F/NAV message contained in the structure.
Value: 1538
TYPE_GAL_I
static val TYPE_GAL_I: Int
Galileo I/NAV message contained in the structure.
Value: 1537
TYPE_GLO_L1CA
static val TYPE_GLO_L1CA: Int
Glonass L1 CA message contained in the structure.
Value: 769
TYPE_GPS_CNAV2
static val TYPE_GPS_CNAV2: Int
GPS CNAV-2 message contained in the structure.
Value: 260
TYPE_GPS_L1CA
static val TYPE_GPS_L1CA: Int
GPS L1 C/A message contained in the structure.
Value: 257
TYPE_GPS_L2CNAV
static val TYPE_GPS_L2CNAV: Int
GPS L2-CNAV message contained in the structure.
Value: 258
TYPE_GPS_L5CNAV
static val TYPE_GPS_L5CNAV: Int
GPS L5-CNAV message contained in the structure.
Value: 259
TYPE_IRN_L1
static val TYPE_IRN_L1: Int
NavIC L1 message contained in the structure.
Value: 1795
TYPE_IRN_L5
static val TYPE_IRN_L5: Int
NavIC L5 message contained in the structure.
Value: 1794
TYPE_IRN_L5CA
static val TYPE_IRN_L5CA: Int
NavIC L5 C/A message contained in the structure.
Value: 1793
TYPE_QZS_L1CA
static val TYPE_QZS_L1CA: Int
QZSS L1 C/A message contained in the structure.
Value: 1025
TYPE_SBS
static val TYPE_SBS: Int
SBAS message contained in the structure.
Value: 513
Public methods
describeContents
fun describeContents(): Int
Return | |
---|---|
Int |
a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either 0 or android.os.Parcelable#CONTENTS_FILE_DESCRIPTOR |
getData
fun getData(): ByteArray
Gets the data of the reported GNSS message.
The bytes (or words) specified using big endian format (MSB first).
- For GPS L1 C/A, NavIC L5, 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).
- For SBAS, each block consists of 250 data bits, that should be fit into 32 bytes. MSB first (skip B251-B256).
- For Beidou CNAV1, subframe #1 consists of 14 data bits, that should be fit into 2 bytes. MSB first (skip B15-B16). subframe #2 consists of 600 bits that should be fit into 75 bytes. subframe #3 consists of 264 data bits that should be fit into 33 bytes.
- For Beidou CNAV2, each subframe consists of 288 data bits, that should be fit into 36 bytes.
- For NavIC L1, subframe #1 consists of 9 data bits that should be fit into 2 bytes (skip B10-B16). subframe #2 consists of 600 bits that should be fit into 75 bytes. subframe #3 consists of 274 data bits that should be fit into 35 bytes (skip B275-B280).
Return | |
---|---|
ByteArray |
This value cannot be null . |
getMessageId
fun getMessageId(): Int
Gets the Message identifier.
This provides an index to help with complete Navigation Message assembly. Similar identifiers within the data bits themselves often supplement this information, in ways even more specific to each message type; see the relevant satellite constellation ICDs for details.
- 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
- For SBAS and Beidou CNAV2, this is unused and can be set to -1.
- For QZSS 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 Beidou CNAV1 this refers to the page type number in the range of 1-63.
- For NavIC L5 subframe 3 and 4, this value corresponds to the Message Id of the navigation message, in the range of 1-63. (Subframe 1 and 2 does not contain a message type id and this value can be set to -1.)
- For NavIC L1 subframe 3, this value corresponds to the Message Id of the navigation message, in the range of 1-63. (Subframe 1 and 2 does not contain a message type id and this value can be set to -1.)
Return | |
---|---|
Int |
Value is between -1 and 120 inclusive |
getStatus
fun getStatus(): Int
Gets the Status of the navigation message contained in the object.
Return | |
---|---|
Int |
Value is android.location.GnssNavigationMessage#STATUS_UNKNOWN , android.location.GnssNavigationMessage#STATUS_PARITY_PASSED , or android.location.GnssNavigationMessage#STATUS_PARITY_REBUILT |
getSubmessageId
fun getSubmessageId(): Int
Gets the sub-message identifier, relevant to the getType()
of the message.
- 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.
- For SBAS, the submessage id corresponds to the message type, in the range 1-63.
- For Beidou CNAV1, the submessage id corresponds to the subframe number of the navigation message, in the range of 1-3.
- For Beidou CNAV2, the submessage id corresponds to the message type, in the range 1-63.
- For NavIC L5, the submessage id corresponds to the subframe number of the navigation message, in the range of 1-4.
- For NavIC L1, the submessage id corresponds to the subframe number of the navigation message, in the range of 1-3.
Return | |
---|---|
Int |
Value is 1 or greater |
getSvid
fun getSvid(): Int
Gets the satellite ID.
Range varies by constellation. See definition at GnssStatus#getSvid(int)
Return | |
---|---|
Int |
Value is between 1 and 200 inclusive |
getType
fun getType(): Int
Gets the type of the navigation message contained in the object.
toString
fun toString(): String
Return | |
---|---|
String |
a string representation of the object. |
writeToParcel
fun writeToParcel(
: Parcel,
: Int
): Unit
Parameters | |
---|---|
dest |
The Parcel in which the object should be written. This value cannot be null . |
flags |
Int: Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE . Value is either 0 or a combination of android.os.Parcelable#PARCELABLE_WRITE_RETURN_VALUE , and android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES |