GnssMeasurement

ADR_STATE_CYCLE_SLIP

int ADR_STATE_CYCLE_SLIP

The state of the 'Accumulated Delta Range' has a cycle slip detected.

Constant Value: 4 (0x00000004)

ADR_STATE_RESET

int ADR_STATE_RESET

The state of the 'Accumulated Delta Range' has detected a reset.

Constant Value: 2 (0x00000002)

ADR_STATE_UNKNOWN

int ADR_STATE_UNKNOWN

The state of the 'Accumulated Delta Range' is invalid or unknown.

Constant Value: 0 (0x00000000)

ADR_STATE_VALID

int ADR_STATE_VALID

The state of the 'Accumulated Delta Range' is valid.

Constant Value: 1 (0x00000001)

MULTIPATH_INDICATOR_DETECTED

int MULTIPATH_INDICATOR_DETECTED

The measurement shows signs of multi-path.

Constant Value: 1 (0x00000001)

MULTIPATH_INDICATOR_NOT_DETECTED

int MULTIPATH_INDICATOR_NOT_DETECTED

The measurement shows no signs of multi-path.

Constant Value: 2 (0x00000002)

MULTIPATH_INDICATOR_UNKNOWN

int MULTIPATH_INDICATOR_UNKNOWN

The indicator is not available or the presence or absence of multipath is unknown.

Constant Value: 0 (0x00000000)

STATE_BDS_D2_BIT_SYNC

int STATE_BDS_D2_BIT_SYNC

This Beidou measurement's tracking state has D2 bit sync.

Constant Value: 256 (0x00000100)

STATE_BDS_D2_SUBFRAME_SYNC

int STATE_BDS_D2_SUBFRAME_SYNC

This Beidou measurement's tracking state has D2 sub-frame sync.

Constant Value: 512 (0x00000200)

STATE_BIT_SYNC

int STATE_BIT_SYNC

This GNSS measurement's tracking state has bit sync.

Constant Value: 2 (0x00000002)

STATE_CODE_LOCK

int STATE_CODE_LOCK

This GNSS measurement's tracking state has code lock.

Constant Value: 1 (0x00000001)

STATE_GAL_E1BC_CODE_LOCK

int STATE_GAL_E1BC_CODE_LOCK

This Galileo measurement's tracking state has E1B/C code lock.

Constant Value: 1024 (0x00000400)

STATE_GAL_E1B_PAGE_SYNC

int STATE_GAL_E1B_PAGE_SYNC

This Galileo measurement's tracking state has E1B page sync.

Constant Value: 4096 (0x00001000)

STATE_GAL_E1C_2ND_CODE_LOCK

int STATE_GAL_E1C_2ND_CODE_LOCK

This Galileo measurement's tracking state has E1C secondary code lock.

Constant Value: 2048 (0x00000800)

STATE_GLO_STRING_SYNC

int STATE_GLO_STRING_SYNC

This Glonass measurement's tracking state has string sync.

Constant Value: 64 (0x00000040)

STATE_GLO_TOD_DECODED

int STATE_GLO_TOD_DECODED

This Glonass measurement's tracking state has time-of-day decoded.

Constant Value: 128 (0x00000080)

STATE_MSEC_AMBIGUOUS

int STATE_MSEC_AMBIGUOUS

This GNSS measurement's tracking state contains millisecond ambiguity.

Constant Value: 16 (0x00000010)

STATE_SBAS_SYNC

int STATE_SBAS_SYNC

This SBAS measurement's tracking state has whole second level sync.

Constant Value: 8192 (0x00002000)

STATE_SUBFRAME_SYNC

int STATE_SUBFRAME_SYNC

This GNSS measurement's tracking state has sub-frame sync.

Constant Value: 4 (0x00000004)

STATE_SYMBOL_SYNC

int STATE_SYMBOL_SYNC

This GNSS measurement's tracking state has symbol sync.

Constant Value: 32 (0x00000020)

STATE_TOW_DECODED

int STATE_TOW_DECODED

This GNSS measurement's tracking state has time-of-week decoded.

Constant Value: 8 (0x00000008)

STATE_UNKNOWN

int STATE_UNKNOWN

This GNSS measurement's tracking state is invalid or unknown.

Constant Value: 0 (0x00000000)

CREATOR

Creator<GnssMeasurement> CREATOR

describeContents

int describeContents ()

Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. For example, if the object will include a file descriptor in the output of writeToParcel(Parcel, int), the return value of this method must include the CONTENTS_FILE_DESCRIPTOR bit.

getAccumulatedDeltaRangeMeters

double getAccumulatedDeltaRangeMeters ()

Gets the accumulated delta range since the last channel reset, in meters.

The error estimate for this value is getAccumulatedDeltaRangeUncertaintyMeters().

The availability of the value is represented by getAccumulatedDeltaRangeState().

A positive value indicates that the SV is moving away from the receiver. The sign of getAccumulatedDeltaRangeMeters() and its relation to the sign of getCarrierPhase() is given by the equation:

          accumulated delta range = -k * carrier phase    (where k is a constant)

getAccumulatedDeltaRangeState

int getAccumulatedDeltaRangeState ()

Gets 'Accumulated Delta Range' state.

It indicates whether getAccumulatedDeltaRangeMeters() is reset or there is a cycle slip (indicating 'loss of lock').

getAccumulatedDeltaRangeUncertaintyMeters

double getAccumulatedDeltaRangeUncertaintyMeters ()

Gets the accumulated delta range's uncertainty (1-Sigma) in meters.

The uncertainty is represented as an absolute (single sided) value.

The status of the value is represented by getAccumulatedDeltaRangeState().

getCarrierCycles

long getCarrierCycles ()

The number of full carrier cycles between the satellite and the receiver.

The reference frequency is given by the value of getCarrierFrequencyHz().

The value is only available if hasCarrierCycles() is true.

getCarrierFrequencyHz

float getCarrierFrequencyHz ()

Gets the carrier frequency at which codes and messages are modulated.

For GPS, e.g., it can be L1 or L2. If the field is not set, it is the primary common use frequency, e.g. L1 for GPS.

The value is only available if hasCarrierFrequencyHz() is true.

getCarrierPhase

double getCarrierPhase ()

Gets the RF phase detected by the receiver.

Range: [0.0, 1.0].

This is the fractional part of the complete carrier phase measurement.

The reference frequency is given by the value of getCarrierFrequencyHz().

The error estimate for this value is getCarrierPhaseUncertainty().

The value is only available if hasCarrierPhase() is true.

getCarrierPhaseUncertainty

double getCarrierPhaseUncertainty ()

Gets the carrier-phase's uncertainty (1-Sigma).

The uncertainty is represented as an absolute (single sided) value.

The value is only available if hasCarrierPhaseUncertainty() is true.

getCn0DbHz

double getCn0DbHz ()

Gets the Carrier-to-noise density in dB-Hz.

Typical range: 10-50 db-Hz.

The value contains the measured C/N0 for the signal at the antenna input.

getConstellationType

int getConstellationType ()

Gets the constellation type.

The return value is one of those constants with CONSTELLATION_ prefix in GnssStatus.

getMultipathIndicator

int getMultipathIndicator ()

Gets a value indicating the 'multipath' state of the event.

getPseudorangeRateMetersPerSecond

double getPseudorangeRateMetersPerSecond ()

Gets the Pseudorange rate at the timestamp in m/s.

The error estimate for this value is getPseudorangeRateUncertaintyMetersPerSecond().

The value is uncorrected, i.e. corrections for receiver and satellite clock frequency errors are not included.

A positive 'uncorrected' value indicates that the SV is moving away from the receiver. The sign of the 'uncorrected' 'pseudorange rate' and its relation to the sign of 'doppler shift' is given by the equation:

      pseudorange rate = -k * doppler shift   (where k is a constant)

getPseudorangeRateUncertaintyMetersPerSecond

double getPseudorangeRateUncertaintyMetersPerSecond ()

Gets the pseudorange's rate uncertainty (1-Sigma) in m/s.

The uncertainty is represented as an absolute (single sided) value.

getReceivedSvTimeNanos

long getReceivedSvTimeNanos ()

Gets the received GNSS satellite time, at the measurement time, in nanoseconds.

For GPS & QZSS, this is:

• Received GPS Time-of-Week at the measurement time, in nanoseconds.
• The value is relative to the beginning of the current GPS week.

Given the highest sync state that can be achieved, per each satellite, valid range for this field can be:

     Searching       : [ 0       ]   : STATE_UNKNOWN
     C/A code lock   : [ 0   1ms ]   : STATE_CODE_LOCK is set
     Bit sync        : [ 0  20ms ]   : STATE_BIT_SYNC is set
     Subframe sync   : [ 0    6s ]   : STATE_SUBFRAME_SYNC is set
     TOW decoded     : [ 0 1week ]   : STATE_TOW_DECODED is set

Note well: if there is any ambiguity in integer millisecond, STATE_MSEC_AMBIGUOUS should be set accordingly, in the 'state' field.

This value must be populated if 'state' != STATE_UNKNOWN.

For Glonass, this is:

• Received Glonass time of day, at the measurement time in nanoseconds.

Given the highest sync state that can be achieved, per each satellite, valid range for this field can be:

     Searching       : [ 0       ]   : STATE_UNKNOWN
     C/A code lock   : [ 0   1ms ]   : STATE_CODE_LOCK is set
     Symbol sync     : [ 0  10ms ]   : STATE_SYMBOL_SYNC is set
     Bit sync        : [ 0  20ms ]   : STATE_BIT_SYNC is set
     String sync     : [ 0    2s ]   : STATE_GLO_STRING_SYNC is set
     Time of day     : [ 0  1day ]   : STATE_GLO_TOD_DECODED is set

For Beidou, this is:

• Received Beidou time of week, at the measurement time in nanoseconds.

Given the highest sync state that can be achieved, per each satellite, valid range for this field can be:

     Searching       : [ 0       ]   : STATE_UNKNOWN
     C/A code lock   : [ 0   1ms ]   : STATE_CODE_LOCK is set
     Bit sync (D2)   : [ 0   2ms ]   : STATE_BDS_D2_BIT_SYNC is set
     Bit sync (D1)   : [ 0  20ms ]   : STATE_BIT_SYNC is set
     Subframe (D2)   : [ 0  0.6s ]   : STATE_BDS_D2_SUBFRAME_SYNC is set
     Subframe (D1)   : [ 0    6s ]   : STATE_SUBFRAME_SYNC is set
     Time of week    : [ 0 1week ]   : STATE_TOW_DECODED is set

For Galileo, this is:

• Received Galileo time of week, at the measurement time in nanoseconds.

     E1BC code lock   : [ 0   4ms ]  : STATE_GAL_E1BC_CODE_LOCK is set
     E1C 2nd code lock: [ 0 100ms ]  : STATE_GAL_E1C_2ND_CODE_LOCK is set
     E1B page         : [ 0    2s ]  : STATE_GAL_E1B_PAGE_SYNC is set
     Time of week     : [ 0 1week ]  : STATE_GAL_TOW_DECODED is set

For SBAS, this is:

• Received SBAS time, at the measurement time in nanoseconds.

Given the highest sync state that can be achieved, per each satellite, valid range for this field can be:

     Searching       : [ 0       ]   : STATE_UNKNOWN
     C/A code lock   : [ 0   1ms ]   : STATE_CODE_LOCK is set
     Symbol sync     : [ 0   2ms ]   : STATE_SYMBOL_SYNC is set
     Message         : [ 0    1s ]   : STATE_SBAS_SYNC is set

getReceivedSvTimeUncertaintyNanos

long getReceivedSvTimeUncertaintyNanos ()

Gets the error estimate (1-sigma) for the received GNSS time, in nanoseconds.

getSnrInDb

double getSnrInDb ()

Gets the Signal-to-Noise ratio (SNR) in dB.

The value is only available if hasSnrInDb() is true.

getState

int getState ()

Gets per-satellite sync state.

It represents the current sync state for the associated satellite.

This value helps interpret getReceivedSvTimeNanos().

getSvid

int getSvid ()

Gets the satellite ID.

Interpretation depends on getConstellationType(). See getSvid(int).

getTimeOffsetNanos

double getTimeOffsetNanos ()

Gets the time offset at which the measurement was taken in nanoseconds.

The reference receiver's time from which this is offset is specified by getTimeNanos().

The sign of this value is given by the following equation:

      measurement time = TimeNanos + TimeOffsetNanos

The value provides an individual time-stamp for the measurement, and allows sub-nanosecond accuracy.

hasCarrierCycles

boolean hasCarrierCycles ()

Returns true if getCarrierCycles() is available, false otherwise.

hasCarrierFrequencyHz

boolean hasCarrierFrequencyHz ()

Returns true if getCarrierFrequencyHz() is available, false otherwise.

hasCarrierPhase

boolean hasCarrierPhase ()

Returns true if getCarrierPhase() is available, false otherwise.

hasCarrierPhaseUncertainty

boolean hasCarrierPhaseUncertainty ()

Returns true if getCarrierPhaseUncertainty() is available, false otherwise.

hasSnrInDb

boolean hasSnrInDb ()

Returns true if getSnrInDb() is available, false otherwise.

toString

String toString ()

Returns a string representation of the object. In general, the toString method returns a string that "textually represents" this object. The result should be a concise but informative representation that is easy for a person to read. It is recommended that all subclasses override this method.

The toString method for class Object returns a string consisting of the name of the class of which the object is an instance, the at-sign character `@', and the unsigned hexadecimal representation of the hash code of the object. In other words, this method returns a string equal to the value of:

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

writeToParcel

void writeToParcel (Parcel parcel, 
                int flags)

Flatten this object in to a Parcel.