Most visited

Recently visited

Added in API level 24

GnssClock

public final class GnssClock
extends Object implements Parcelable

java.lang.Object
   ↳ android.location.GnssClock


一个包含GPS时钟时间戳的类。

它代表GPS接收机时钟的测量值。

Summary

Inherited constants

From interface android.os.Parcelable

Fields

public static final Creator<GnssClock> CREATOR

Public methods

int describeContents()

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

double getBiasNanos()

获取时钟的亚纳秒偏置。

double getBiasUncertaintyNanos()

以纳秒为单位获取时钟偏差不确定度(1-Sigma)。

double getDriftNanosPerSecond()

获得时钟的漂移,以每秒纳秒为单位。

double getDriftUncertaintyNanosPerSecond()

以纳秒为单位获取时钟的漂移不确定性(1-Sigma)。

long getFullBiasNanos()

获取GPS接收器内硬件时钟( getTimeNanos() )与1980年1月6日0000Z以来的真实GPS时间之间的差异,以纳秒为单位。

int getHardwareClockDiscontinuityCount()

获取硬件时钟不连续性的计数。

int getLeapSecond()

获取与时钟相关的闰秒。

long getTimeNanos()

以纳秒为单位获取GNSS接收器内部硬件时钟值。

double getTimeUncertaintyNanos()

获取时钟的时间不确定性(1-Sigma),以纳秒为单位。

boolean hasBiasNanos()

返回 true如果 getBiasNanos()可用, false否则。

boolean hasBiasUncertaintyNanos()

返回 true如果 getBiasUncertaintyNanos()可用, false否则。

boolean hasDriftNanosPerSecond()

返回 true如果 getDriftNanosPerSecond()可用, false否则。

boolean hasDriftUncertaintyNanosPerSecond()

返回 true如果 getDriftUncertaintyNanosPerSecond()可用, false否则。

boolean hasFullBiasNanos()

返回 true如果 getFullBiasNanos()可用, false否则。

boolean hasLeapSecond()

返回 true如果 getLeapSecond()可用, false否则。

boolean hasTimeUncertaintyNanos()

返回 true如果 getTimeUncertaintyNanos()可用, false否则。

String toString()

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

void writeToParcel(Parcel parcel, int flags)

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

Inherited methods

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

Fields

CREATOR

Added in API level 24
Creator<GnssClock> 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.

getBiasNanos

Added in API level 24
double getBiasNanos ()

获取时钟的亚纳秒偏置。

请参阅 getFullBiasNanos()有关此字段如何从硬件时钟时间转换为GPS时间的 getFullBiasNanos()

此字段和 getFullBiasNanos()的总和的错误估计值为 getBiasUncertaintyNanos()

该值仅在 hasBiasNanos()true可用。

Returns
double

getBiasUncertaintyNanos

Added in API level 24
double getBiasUncertaintyNanos ()

以纳秒为单位获取时钟偏差不确定度(1-Sigma)。

请参阅 getFullBiasNanos()中关于此字段如何提供从硬件时钟时间到GPS时间转换中的误差估计的 getFullBiasNanos()

该值仅在 hasBiasUncertaintyNanos()true可用。

Returns
double

getDriftNanosPerSecond

Added in API level 24
double getDriftNanosPerSecond ()

获得时钟的漂移,以每秒纳秒为单位。

正值表示频率高于标称值(例如GPS主时钟)的频率。 此报告的漂移的误差估计为getDriftUncertaintyNanosPerSecond()

该值仅在 hasDriftNanosPerSecond()true可用。

Returns
double

getDriftUncertaintyNanosPerSecond

Added in API level 24
double getDriftUncertaintyNanosPerSecond ()

以纳秒为单位获取时钟的漂移不确定性(1-Sigma)。

该值仅在 hasDriftUncertaintyNanosPerSecond()true可用。

Returns
double

getFullBiasNanos

Added in API level 24
long getFullBiasNanos ()

获取GPS接收器内部硬件时钟( getTimeNanos() )与1980年1月6日0000Z以来的真实GPS时间之间的差异,以纳秒为单位。

如果接收机具有估计的GPS时间,则此值可用。 如果所计算的时间是针对非GPS星座的,则必须应用该星座对GPS的时间偏移以填充该值。 该值仅在hasFullBiasNanos()true可用。

该字段和 getBiasNanos()的总和的错误估计是 getBiasUncertaintyNanos()

值的符号由以下等式定义:

     local estimate of GPS time = TimeNanos - (FullBiasNanos + BiasNanos)

Returns
long

getHardwareClockDiscontinuityCount

Added in API level 24
int getHardwareClockDiscontinuityCount ()

获取硬件时钟不连续性的计数。

当此值与之前报告的 GnssClock中的值保持相同时,可以安全地假定 TimeNanos值是从连续运行的时钟(例如,单个持续供电的晶体振荡器) (FullBiasNanos + BiasNanos) ,因此 (FullBiasNanos + BiasNanos)偏移可以用传统的时钟偏移和漂移模型进行建模。

每个该值发生变化,相对于在α的值之前报道时间 GnssClock ,那么就表明该硬件时钟可能经历的不连续性(例如功率循环或其他异常),使约建模的平滑地变化的任何假设 (FullBiasNanos + BiasNanos)偏移,以及发展顺利 (TimeNanos)这与此前报道之间 GnssClock ,应归零。

Returns
int

getLeapSecond

Added in API level 24
int getLeapSecond ()

获取与时钟相关的闰秒。

值的符号由以下等式定义:

     UtcTimeNanos = TimeNanos - (FullBiasNanos + BiasNanos) - LeapSecond * 1,000,000,000

该值仅在 hasLeapSecond()true可用。

Returns
int

getTimeNanos

Added in API level 24
long getTimeNanos ()

以纳秒为单位获取GNSS接收器内部硬件时钟值。

在硬件时钟保持开机的情况下,该值预计会单调递增。 对于非持续开启的硬件时钟,请参阅getHardwareClockDiscontinuityCount()字段。 GPS时间可以通过从该值减去getFullBiasNanos()getBiasNanos()之和(当它们可用时)来得出。 亚纳秒精度可通过getBiasNanos()

此值的误差估计值(如果适用)为 getTimeUncertaintyNanos()

Returns
long

getTimeUncertaintyNanos

Added in API level 24
double getTimeUncertaintyNanos ()

获取时钟的时间不确定性(1-Sigma),以纳秒为单位。

不确定性表示为绝对(单面)值。

该值仅在 hasTimeUncertaintyNanos()true可用。

该值通常实际上为零(它是测量所有其他时间和时间不确定性的参考时钟),因此该字段可能通常为0或不提供。

Returns
double

hasBiasNanos

Added in API level 24
boolean hasBiasNanos ()

返回 true如果 getBiasNanos()可用, false否则。

Returns
boolean

hasBiasUncertaintyNanos

Added in API level 24
boolean hasBiasUncertaintyNanos ()

返回 true如果 getBiasUncertaintyNanos()可用, false否则。

Returns
boolean

hasDriftNanosPerSecond

Added in API level 24
boolean hasDriftNanosPerSecond ()

返回 true如果 getDriftNanosPerSecond()可用, false否则。

Returns
boolean

hasDriftUncertaintyNanosPerSecond

Added in API level 24
boolean hasDriftUncertaintyNanosPerSecond ()

返回 true如果 getDriftUncertaintyNanosPerSecond()可用, false否则。

Returns
boolean

hasFullBiasNanos

Added in API level 24
boolean hasFullBiasNanos ()

返回 true如果 getFullBiasNanos()可用, false否则。

Returns
boolean

hasLeapSecond

Added in API level 24
boolean hasLeapSecond ()

返回 true如果 getLeapSecond()可用, false否则。

Returns
boolean

hasTimeUncertaintyNanos

Added in API level 24
boolean hasTimeUncertaintyNanos ()

返回 true如果 getTimeUncertaintyNanos()可用, false否则。

Returns
boolean

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!