android.location.Criteria
A class indicating the application criteria for selecting a
location provider. Providers maybe ordered according to accuracy,
power usage, ability to report altitude, speed,
and bearing, and monetary cost.
Summary
Constants
|
|
|
Value |
|
int |
ACCURACY_COARSE |
A constant indicating an approximate accuracy requirement
|
2 |
0x00000002 |
int |
ACCURACY_FINE |
A constant indicating a finer location accuracy requirement
|
1 |
0x00000001 |
Creator<Criteria> |
CREATOR |
|
|
|
int |
NO_REQUIREMENT |
A constant indicating that the application does not choose to
place requirement on a particular feature. |
0 |
0x00000000 |
int |
POWER_HIGH |
A constant indicating a high power requirement. |
3 |
0x00000003 |
int |
POWER_LOW |
A constant indicating a low power requirement. |
1 |
0x00000001 |
int |
POWER_MEDIUM |
A constant indicating a medium power requirement. |
2 |
0x00000002 |
Public Constructors
Public Methods
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait
Details
Constants
public
static
final
int
ACCURACY_COARSE
A constant indicating an approximate accuracy requirement
Constant Value:
2
(0x00000002)
public
static
final
int
ACCURACY_FINE
A constant indicating a finer location accuracy requirement
Constant Value:
1
(0x00000001)
public
static
final
int
NO_REQUIREMENT
A constant indicating that the application does not choose to
place requirement on a particular feature.
Constant Value:
0
(0x00000000)
public
static
final
int
POWER_HIGH
A constant indicating a high power requirement.
Constant Value:
3
(0x00000003)
public
static
final
int
POWER_LOW
A constant indicating a low power requirement.
Constant Value:
1
(0x00000001)
public
static
final
int
POWER_MEDIUM
A constant indicating a medium power requirement.
Constant Value:
2
(0x00000002)
Public Constructors
public
Criteria()
Constructs a new Criteria object. The new object will have no
requirements on accuracy, power, or response time; will not
require altitude, speed, or bearing; and will not allow monetary
cost.
public
Criteria(Criteria criteria)
Constructs a new Criteria object that is a copy of the given criteria.
Public Methods
public
int
describeContents()
Describe the kinds of special objects contained in this Parcelable's
marshalled representation.
public
int
getAccuracy()
Returns a constant indicating desired accuracy of location
Accuracy may be
ACCURACY_FINE if desired location
is fine, else it can be
ACCURACY_COARSE.
public
int
getPowerRequirement()
Returns a constant indicating the desired power requirement. The
returned
public
boolean
isAltitudeRequired()
Returns whether the provider must provide altitude information.
Not all fixes are guaranteed to contain such information.
public
boolean
isBearingRequired()
Returns whether the provider must provide bearing information.
Not all fixes are guaranteed to contain such information.
public
boolean
isCostAllowed()
Returns whether the provider is allowed to incur monetary cost.
public
boolean
isSpeedRequired()
Returns whether the provider must provide speed information.
Not all fixes are guaranteed to contain such information.
public
void
setAccuracy(int accuracy)
Indicates the desired accuracy for latitude and longitude. Accuracy
may be
ACCURACY_FINE if desired location
is fine, else it can be
ACCURACY_COARSE.
More accurate location usually consumes more power and may take
longer.
public
void
setAltitudeRequired(boolean altitudeRequired)
Indicates whether the provider must provide altitude information.
Not all fixes are guaranteed to contain such information.
public
void
setBearingRequired(boolean bearingRequired)
Indicates whether the provider must provide bearing information.
Not all fixes are guaranteed to contain such information.
public
void
setCostAllowed(boolean costAllowed)
Indicates whether the provider is allowed to incur monetary cost.
public
void
setPowerRequirement(int level)
Indicates the desired maximum power level. The level parameter
must be one of NO_REQUIREMENT, POWER_LOW, POWER_MEDIUM, or
POWER_HIGH.
public
void
setSpeedRequired(boolean speedRequired)
Indicates whether the provider must provide speed information.
Not all fixes are guaranteed to contain such information.
public
void
writeToParcel(Parcel parcel, int flags)
Flatten this object in to a Parcel.