public class Criteria
extends Object
implements Parcelable
java.lang.Object | |
↳ | android.location.Criteria |
指示选择位置提供者的应用标准的类。 供应商可根据准确性,用电量,报告海拔高度,速度和方位以及货币成本的能力进行订购。
Constants |
|
---|---|
int |
ACCURACY_COARSE 表示近似精度要求的常数 |
int |
ACCURACY_FINE 一个常数,表示更精确的位置精度要求 |
int |
ACCURACY_HIGH 一个表示高精度要求的常数 - 可用于水平,高度,速度或轴承精度。 |
int |
ACCURACY_LOW 表示低位置精度要求的常数 - 可以用于水平,高度,速度或轴承精度。 |
int |
ACCURACY_MEDIUM 表示中等精度要求的常数 - 目前仅用于水平精度。 |
int |
NO_REQUIREMENT 表示应用程序不选择将要求放在特定功能上的常数。 |
int |
POWER_HIGH 表示高功率要求的常数。 |
int |
POWER_LOW 表示低功耗要求的常数。 |
int |
POWER_MEDIUM 表示中等功率要求的常数。 |
Inherited constants |
---|
From interface android.os.Parcelable
|
Fields |
|
---|---|
public static final Creator<Criteria> |
CREATOR |
Public constructors |
|
---|---|
Criteria() 构造一个新的Criteria对象。 |
|
Criteria(Criteria criteria) 构造一个新的Criteria对象,它是给定条件的副本。 |
Public methods |
|
---|---|
int |
describeContents() 描述此Parcelable实例的封送表示中包含的特殊对象的种类。 |
int |
getAccuracy() 返回一个常数,指示所需的定位精度如果需要的位置正确,则精度可能是 |
int |
getBearingAccuracy() 返回一个常数,表示所需的轴承精度。 |
int |
getHorizontalAccuracy() 返回一个常数,指示所需的水平精度(经度和纬度)。 |
int |
getPowerRequirement() 返回一个常数,指示所需的功率要求。 |
int |
getSpeedAccuracy() 返回指示所期望的速度准确度精度一个常数可以是 |
int |
getVerticalAccuracy() 返回一个常数,指示所需的垂直精度(高度)。 |
boolean |
isAltitudeRequired() 返回提供者是否必须提供高度信息。 |
boolean |
isBearingRequired() 返回提供者是否必须提供方位信息。 |
boolean |
isCostAllowed() 返回提供者是否被允许产生货币成本。 |
boolean |
isSpeedRequired() 返回提供者是否必须提供速度信息。 |
void |
setAccuracy(int accuracy) 表示纬度和经度的理想精度。 |
void |
setAltitudeRequired(boolean altitudeRequired) 指示提供者是否必须提供高度信息。 |
void |
setBearingAccuracy(int accuracy) 指示所需的轴承精度。 |
void |
setBearingRequired(boolean bearingRequired) 指示提供者是否必须提供方位信息。 |
void |
setCostAllowed(boolean costAllowed) 指示提供者是否被允许产生货币成本。 |
void |
setHorizontalAccuracy(int accuracy) 指示所需的水平精度(经度和纬度)。 |
void |
setPowerRequirement(int level) 指示所需的最大功率级别。 |
void |
setSpeedAccuracy(int accuracy) 指示所需的速度准确度。 |
void |
setSpeedRequired(boolean speedRequired) 指示提供者是否必须提供速度信息。 |
void |
setVerticalAccuracy(int accuracy) 指示所需的垂直精度(高度)。 |
String |
toString() 返回对象的字符串表示形式。 |
void |
writeToParcel(Parcel parcel, int flags) 将此对象平铺到一个包裹中。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
|
From interface android.os.Parcelable
|
int ACCURACY_HIGH
一个表示高精度要求的常数 - 可用于水平,高度,速度或轴承精度。 对于水平和垂直位置,这大致对应于小于100米的精度。
常量值:3(0x00000003)
int ACCURACY_LOW
表示低位置精度要求的常数 - 可以用于水平,高度,速度或轴承精度。 对于水平和垂直位置,这大致对应于大于500米的精度。
常数值:1(0x00000001)
int ACCURACY_MEDIUM
表示中等精度要求的常数 - 目前仅用于水平精度。 对于水平位置,这大致对应于100至500米之间的精度。
常量值:2(0x00000002)
Criteria ()
构造一个新的Criteria对象。 新对象对精度,功耗或响应时间没有要求; 将不需要高度,速度或方位; 并不会允许货币成本。
Criteria (Criteria criteria)
构造一个新的Criteria对象,它是给定条件的副本。
Parameters | |
---|---|
criteria |
Criteria
|
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. |
int getAccuracy ()
返回一个常数,指示期望的定位精度。如果需要的位置正确,精度可能是 ACCURACY_FINE
,否则可以是 ACCURACY_COARSE
。
Returns | |
---|---|
int |
int getBearingAccuracy ()
返回一个常数,表示所需的轴承精度。 精度可能ACCURACY_LOW
, ACCURACY_HIGH
,或NO_REQUIREMENT
。
Returns | |
---|---|
int |
int getHorizontalAccuracy ()
返回一个常数,指示所需的水平精度(经度和纬度)。 精度可能ACCURACY_LOW
, ACCURACY_MEDIUM
, ACCURACY_HIGH
或者NO_REQUIREMENT
。
Returns | |
---|---|
int |
int getPowerRequirement ()
返回一个常数,指示所需的功率要求。 返回的
Returns | |
---|---|
int |
int getSpeedAccuracy ()
返回指示所期望的速度准确度精度一个常数可以是 ACCURACY_LOW
, ACCURACY_HIGH
,或 NO_REQUIREMENT
。
Returns | |
---|---|
int |
int getVerticalAccuracy ()
返回一个常数,指示所需的垂直精度(高度)。 精度可能ACCURACY_LOW
, ACCURACY_HIGH
,或NO_REQUIREMENT
。
Returns | |
---|---|
int |
boolean isAltitudeRequired ()
返回提供者是否必须提供高度信息。 并非所有修复都保证包含这些信息。
Returns | |
---|---|
boolean |
boolean isBearingRequired ()
返回提供者是否必须提供方位信息。 并非所有修复都保证包含这些信息。
Returns | |
---|---|
boolean |
boolean isSpeedRequired ()
返回提供者是否必须提供速度信息。 并非所有修复都保证包含这些信息。
Returns | |
---|---|
boolean |
void setAccuracy (int accuracy)
表示纬度和经度的理想精度。 如果需要的位置很好,则精度可能是ACCURACY_FINE
,否则可能是ACCURACY_COARSE
。 更准确的位置可能会消耗更多的电力,可能需要更长的时间
Parameters | |
---|---|
accuracy |
int
|
Throws | |
---|---|
IllegalArgumentException |
if accuracy is not one of the supported constants |
void setAltitudeRequired (boolean altitudeRequired)
指示提供者是否必须提供高度信息。 并非所有修复都保证包含这些信息。
Parameters | |
---|---|
altitudeRequired |
boolean
|
void setBearingAccuracy (int accuracy)
指示所需的轴承精度。 精度可能ACCURACY_LOW
, ACCURACY_HIGH
,或NO_REQUIREMENT
。 更准确的位置可能会消耗更多的电力,可能需要更长的时间
Parameters | |
---|---|
accuracy |
int
|
Throws | |
---|---|
IllegalArgumentException |
if accuracy is not one of the supported constants |
void setBearingRequired (boolean bearingRequired)
指示提供者是否必须提供方位信息。 并非所有修复都保证包含这些信息。
Parameters | |
---|---|
bearingRequired |
boolean
|
void setCostAllowed (boolean costAllowed)
指示提供者是否被允许产生货币成本。
Parameters | |
---|---|
costAllowed |
boolean
|
void setHorizontalAccuracy (int accuracy)
指示所需的水平精度(经度和纬度)。 精度可能ACCURACY_LOW
, ACCURACY_MEDIUM
, ACCURACY_HIGH
或者NO_REQUIREMENT
。 更准确的位置可能会消耗更多的电力,可能需要更长的时间
Parameters | |
---|---|
accuracy |
int
|
Throws | |
---|---|
IllegalArgumentException |
if accuracy is not one of the supported constants |
void setPowerRequirement (int level)
指示所需的最大功率级别。 level参数必须是NO_REQUIREMENT,POWER_LOW,POWER_MEDIUM或POWER_HIGH中的一个。
Parameters | |
---|---|
level |
int
|
void setSpeedAccuracy (int accuracy)
指示所需的速度准确度。 精度可能ACCURACY_LOW
, ACCURACY_HIGH
,或NO_REQUIREMENT
。 更准确的位置可能会消耗更多的电力,可能需要更长的时间
Parameters | |
---|---|
accuracy |
int
|
Throws | |
---|---|
IllegalArgumentException |
if accuracy is not one of the supported constants |
void setSpeedRequired (boolean speedRequired)
指示提供者是否必须提供速度信息。 并非所有修复都保证包含这些信息。
Parameters | |
---|---|
speedRequired |
boolean
|
void setVerticalAccuracy (int accuracy)
指示所需的垂直精度(高度)。 精度可能ACCURACY_LOW
, ACCURACY_MEDIUM
, ACCURACY_HIGH
或者NO_REQUIREMENT
。 更准确的位置可能会消耗更多的电力,可能需要更长的时间
Parameters | |
---|---|
accuracy |
int
|
Throws | |
---|---|
IllegalArgumentException |
if accuracy is not one of the supported constants |
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 . |