public final class GnssClock
extends Object
implements Parcelable
java.lang.Object | |
↳ | android.location.GnssClock |
一个包含GPS时钟时间戳的类。
它代表GPS接收机时钟的测量值。
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接收器内硬件时钟( |
int |
getHardwareClockDiscontinuityCount() 获取硬件时钟不连续性的计数。 |
int |
getLeapSecond() 获取与时钟相关的闰秒。 |
long |
getTimeNanos() 以纳秒为单位获取GNSS接收器内部硬件时钟值。 |
double |
getTimeUncertaintyNanos() 获取时钟的时间不确定性(1-Sigma),以纳秒为单位。 |
boolean |
hasBiasNanos() 返回 |
boolean |
hasBiasUncertaintyNanos() 返回 |
boolean |
hasDriftNanosPerSecond() 返回 |
boolean |
hasDriftUncertaintyNanosPerSecond() 返回 |
boolean |
hasFullBiasNanos() 返回 |
boolean |
hasLeapSecond() 返回 |
boolean |
hasTimeUncertaintyNanos() 返回 |
String |
toString() 返回对象的字符串表示形式。 |
void |
writeToParcel(Parcel parcel, int flags) 将此对象平铺到一个包裹中。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
|
From interface android.os.Parcelable
|
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. |
double getBiasNanos ()
获取时钟的亚纳秒偏置。
请参阅 getFullBiasNanos()
有关此字段如何从硬件时钟时间转换为GPS时间的 getFullBiasNanos()
。
此字段和 getFullBiasNanos()
的总和的错误估计值为 getBiasUncertaintyNanos()
。
该值仅在 hasBiasNanos()
为 true
可用。
Returns | |
---|---|
double |
double getBiasUncertaintyNanos ()
以纳秒为单位获取时钟偏差不确定度(1-Sigma)。
请参阅 getFullBiasNanos()
中关于此字段如何提供从硬件时钟时间到GPS时间转换中的误差估计的 getFullBiasNanos()
。
该值仅在 hasBiasUncertaintyNanos()
为 true
可用。
Returns | |
---|---|
double |
double getDriftNanosPerSecond ()
获得时钟的漂移,以每秒纳秒为单位。
正值表示频率高于标称值(例如GPS主时钟)的频率。 此报告的漂移的误差估计为getDriftUncertaintyNanosPerSecond()
。
该值仅在 hasDriftNanosPerSecond()
为 true
可用。
Returns | |
---|---|
double |
double getDriftUncertaintyNanosPerSecond ()
以纳秒为单位获取时钟的漂移不确定性(1-Sigma)。
该值仅在 hasDriftUncertaintyNanosPerSecond()
为 true
可用。
Returns | |
---|---|
double |
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 |
int getHardwareClockDiscontinuityCount ()
获取硬件时钟不连续性的计数。
当此值与之前报告的 GnssClock
中的值保持相同时,可以安全地假定 TimeNanos
值是从连续运行的时钟(例如,单个持续供电的晶体振荡器) (FullBiasNanos + BiasNanos)
,因此 (FullBiasNanos + BiasNanos)
偏移可以用传统的时钟偏移和漂移模型进行建模。
每个该值发生变化,相对于在α的值之前报道时间 GnssClock
,那么就表明该硬件时钟可能经历的不连续性(例如功率循环或其他异常),使约建模的平滑地变化的任何假设 (FullBiasNanos + BiasNanos)
偏移,以及发展顺利 (TimeNanos)
这与此前报道之间 GnssClock
,应归零。
Returns | |
---|---|
int |
int getLeapSecond ()
获取与时钟相关的闰秒。
值的符号由以下等式定义:
UtcTimeNanos = TimeNanos - (FullBiasNanos + BiasNanos) - LeapSecond * 1,000,000,000
该值仅在 hasLeapSecond()
为 true
可用。
Returns | |
---|---|
int |
long getTimeNanos ()
以纳秒为单位获取GNSS接收器内部硬件时钟值。
在硬件时钟保持开机的情况下,该值预计会单调递增。 对于非持续开启的硬件时钟,请参阅getHardwareClockDiscontinuityCount()
字段。 GPS时间可以通过从该值减去getFullBiasNanos()
和getBiasNanos()
之和(当它们可用时)来得出。 亚纳秒精度可通过getBiasNanos()
。
此值的误差估计值(如果适用)为 getTimeUncertaintyNanos()
。
Returns | |
---|---|
long |
double getTimeUncertaintyNanos ()
获取时钟的时间不确定性(1-Sigma),以纳秒为单位。
不确定性表示为绝对(单面)值。
该值仅在 hasTimeUncertaintyNanos()
为 true
可用。
该值通常实际上为零(它是测量所有其他时间和时间不确定性的参考时钟),因此该字段可能通常为0或不提供。
Returns | |
---|---|
double |
boolean hasBiasNanos ()
返回 true
如果 getBiasNanos()
可用, false
否则。
Returns | |
---|---|
boolean |
boolean hasBiasUncertaintyNanos ()
返回 true
如果 getBiasUncertaintyNanos()
可用, false
否则。
Returns | |
---|---|
boolean |
boolean hasDriftNanosPerSecond ()
返回 true
如果 getDriftNanosPerSecond()
可用, false
否则。
Returns | |
---|---|
boolean |
boolean hasDriftUncertaintyNanosPerSecond ()
返回 true
如果 getDriftUncertaintyNanosPerSecond()
可用, false
否则。
Returns | |
---|---|
boolean |
boolean hasFullBiasNanos ()
返回 true
如果 getFullBiasNanos()
可用, false
否则。
Returns | |
---|---|
boolean |
boolean hasLeapSecond ()
返回 true
如果 getLeapSecond()
可用, false
否则。
Returns | |
---|---|
boolean |
boolean hasTimeUncertaintyNanos ()
返回 true
如果 getTimeUncertaintyNanos()
可用, false
否则。
Returns | |
---|---|
boolean |
String toString ()
返回对象的字符串表示形式。 通常, toString
方法将返回一个字符串,“文本地表示”此对象。 结果应该是一个简洁但内容丰富的表述,对于一个人来说很容易阅读。 建议所有子类重写此方法。
类Object
的toString
方法返回一个字符串,其中包含对象为实例的类的名称,符号字符“ @
”以及对象的哈希码的无符号十六进制表示形式。 换句话说,这个方法返回一个字符串,其值等于:
getClass().getName() + '@' + Integer.toHexString(hashCode())
Returns | |
---|---|
String |
a string representation of the object. |
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 . |