Most visited

Recently visited

Results for

Criteria

public class Criteria
extends Object implements Parcelable

java.lang.Object
↳	android.location.Criteria

A class indicating the application criteria for selecting a location provider. Providers may be ordered according to accuracy, power usage, ability to report altitude, speed, bearing, and monetary cost.

Summary

Constants
`int`	`ACCURACY_COARSE` A constant indicating an approximate accuracy requirement
`int`	`ACCURACY_FINE` A constant indicating a finer location accuracy requirement
`int`	`ACCURACY_HIGH` a constant indicating a high accuracy requirement - may be used for horizontal, altitude, speed or bearing accuracy.
`int`	`ACCURACY_LOW` A constant indicating a low location accuracy requirement - may be used for horizontal, altitude, speed or bearing accuracy.
`int`	`ACCURACY_MEDIUM` A constant indicating a medium accuracy requirement - currently used only for horizontal accuracy.
`int`	`NO_REQUIREMENT` A constant indicating that the application does not choose to place requirement on a particular feature.
`int`	`POWER_HIGH` A constant indicating a high power requirement.
`int`	`POWER_LOW` A constant indicating a low power requirement.
`int`	`POWER_MEDIUM` A constant indicating a medium power requirement.

Inherited constants

From interface android.os.Parcelable

`int`	`CONTENTS_FILE_DESCRIPTOR` Descriptor bit used with `describeContents()`: indicates that the Parcelable object's flattened representation includes a file descriptor.
`int`	`PARCELABLE_WRITE_RETURN_VALUE` Flag for use with `writeToParcel(Parcel, int)`: the object being written is a return value, that is the result of a function such as "`Parcelable someFunction()`", "`void someFunction(out Parcelable)`", or "`void someFunction(inout Parcelable)`".

Fields
`public static final Creator<Criteria>`	`CREATOR`

Public constructors
`Criteria()` Constructs a new Criteria object.
`Criteria(Criteria criteria)` Constructs a new Criteria object that is a copy of the given criteria.

Public methods
`int`	`describeContents()` Describe the kinds of special objects contained in this Parcelable instance's marshaled representation.
`int`	`getAccuracy()` Returns a constant indicating desired accuracy of location.
`int`	`getBearingAccuracy()` Returns a constant indicating the desired bearing accuracy.
`int`	`getHorizontalAccuracy()` Returns a constant indicating the desired horizontal accuracy (latitude and longitude).
`int`	`getPowerRequirement()` Returns a constant indicating the desired maximum power requirement.
`int`	`getSpeedAccuracy()` Returns a constant indicating the desired speed accuracy.
`int`	`getVerticalAccuracy()` Returns a constant indicating the desired vertical accuracy (altitude).
`boolean`	`isAltitudeRequired()` Returns whether the provider must provide altitude information.
`boolean`	`isBearingRequired()` Returns whether the provider must provide bearing information.
`boolean`	`isCostAllowed()` Returns whether the provider is allowed to incur monetary cost.
`boolean`	`isSpeedRequired()` Returns whether the provider must provide speed information.
`void`	`setAccuracy(int accuracy)` Indicates the desired accuracy for latitude and longitude.
`void`	`setAltitudeRequired(boolean altitudeRequired)` Indicates whether the provider must provide altitude information.
`void`	`setBearingAccuracy(int accuracy)` Indicates the desired bearing accuracy.
`void`	`setBearingRequired(boolean bearingRequired)` Indicates whether the provider must provide bearing information.
`void`	`setCostAllowed(boolean costAllowed)` Indicates whether the provider is allowed to incur monetary cost.
`void`	`setHorizontalAccuracy(int accuracy)` Indicates the desired horizontal accuracy (latitude and longitude).
`void`	`setPowerRequirement(int powerRequirement)` Indicates the desired maximum power requirement.
`void`	`setSpeedAccuracy(int accuracy)` Indicates the desired speed accuracy.
`void`	`setSpeedRequired(boolean speedRequired)` Indicates whether the provider must provide speed information.
`void`	`setVerticalAccuracy(int accuracy)` Indicates the desired vertical accuracy (altitude).
`String`	`toString()` Returns a string representation of the object.
`void`	`writeToParcel(Parcel parcel, int flags)` Flatten this object in to a Parcel.

Inherited methods

From class


        
          java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long timeout, int nanos)` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
`final void`	`wait(long timeout)` Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.
`final void`	`wait()` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.

From interface


        
          android.os.Parcelable

`abstract int`	`describeContents()` Describe the kinds of special objects contained in this Parcelable instance's marshaled representation.
`abstract void`	`writeToParcel(Parcel dest, int flags)` Flatten this object in to a Parcel.

Constants

ACCURACY_COARSE

public static final int ACCURACY_COARSE

A constant indicating an approximate accuracy requirement

Constant Value: 2 (0x00000002)

ACCURACY_FINE

public static final int ACCURACY_FINE

A constant indicating a finer location accuracy requirement

Constant Value: 1 (0x00000001)

ACCURACY_HIGH

public static final int ACCURACY_HIGH

a constant indicating a high accuracy requirement - may be used for horizontal, altitude, speed or bearing accuracy. For horizontal and vertical position this corresponds roughly to an accuracy of less than 100 meters.

Constant Value: 3 (0x00000003)

ACCURACY_LOW

public static final int ACCURACY_LOW

A constant indicating a low location accuracy requirement - may be used for horizontal, altitude, speed or bearing accuracy. For horizontal and vertical position this corresponds roughly to an accuracy of greater than 500 meters.

Constant Value: 1 (0x00000001)

ACCURACY_MEDIUM

public static final int ACCURACY_MEDIUM

A constant indicating a medium accuracy requirement - currently used only for horizontal accuracy. For horizontal position this corresponds roughly to to an accuracy of between 100 and 500 meters.

Constant Value: 2 (0x00000002)

NO_REQUIREMENT

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)

POWER_HIGH

public static final int POWER_HIGH

A constant indicating a high power requirement.

Constant Value: 3 (0x00000003)

POWER_LOW

public static final int POWER_LOW

A constant indicating a low power requirement.

Constant Value: 1 (0x00000001)

POWER_MEDIUM

public static final int POWER_MEDIUM

A constant indicating a medium power requirement.

Constant Value: 2 (0x00000002)

Fields

CREATOR

public static final Creator<Criteria> CREATOR

Public constructors

Criteria

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.

Criteria

public Criteria (Criteria criteria)

Constructs a new Criteria object that is a copy of the given criteria.

Parameters
`criteria`	`Criteria`

Public methods

describeContents

public 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(android.os.Parcel, int), the return value of this method must include the CONTENTS_FILE_DESCRIPTOR bit.

Returns
`int`	a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either `0` or `CONTENTS_FILE_DESCRIPTOR`

getAccuracy

public int getAccuracy ()

Returns a constant indicating desired accuracy of location.

Returns
`int`	Value is `NO_REQUIREMENT`, `ACCURACY_FINE`, or `ACCURACY_COARSE`

See also:

setAccuracy(int)

getBearingAccuracy

public int getBearingAccuracy ()

Returns a constant indicating the desired bearing accuracy.

Returns
`int`	Value is `NO_REQUIREMENT`, `ACCURACY_LOW`, `ACCURACY_MEDIUM`, or `ACCURACY_HIGH`

See also:

setBearingAccuracy(int)

getHorizontalAccuracy

public int getHorizontalAccuracy ()

Returns a constant indicating the desired horizontal accuracy (latitude and longitude).

Returns
`int`	Value is `NO_REQUIREMENT`, `ACCURACY_LOW`, `ACCURACY_MEDIUM`, or `ACCURACY_HIGH`

See also:

setHorizontalAccuracy(int)

getPowerRequirement

public int getPowerRequirement ()

Returns a constant indicating the desired maximum power requirement.

Returns
`int`	Value is `NO_REQUIREMENT`, `POWER_LOW`, `POWER_MEDIUM`, or `POWER_HIGH`

See also:

setPowerRequirement(int)

getSpeedAccuracy

public int getSpeedAccuracy ()

Returns a constant indicating the desired speed accuracy.

Returns
`int`	Value is `NO_REQUIREMENT`, `ACCURACY_LOW`, `ACCURACY_MEDIUM`, or `ACCURACY_HIGH`

See also:

setSpeedAccuracy(int)

getVerticalAccuracy

public int getVerticalAccuracy ()

Returns a constant indicating the desired vertical accuracy (altitude).

Returns
`int`	Value is `NO_REQUIREMENT`, `ACCURACY_LOW`, `ACCURACY_MEDIUM`, or `ACCURACY_HIGH`

See also:

setVerticalAccuracy(int)

isAltitudeRequired

public boolean isAltitudeRequired ()

Returns whether the provider must provide altitude information.

Returns
`boolean`

See also:

setAltitudeRequired(boolean)

isBearingRequired

public boolean isBearingRequired ()

Returns whether the provider must provide bearing information.

Returns
`boolean`

See also:

setBearingRequired(boolean)

isCostAllowed

public boolean isCostAllowed ()

Returns whether the provider is allowed to incur monetary cost.

Returns
`boolean`

isSpeedRequired

public boolean isSpeedRequired ()

Returns whether the provider must provide speed information.

Returns
`boolean`

See also:

setSpeedRequired(boolean)

setAccuracy

public void setAccuracy (int accuracy)

Indicates the desired accuracy for latitude and longitude. Accuracy may be ACCURACY_FINE or ACCURACY_COARSE. More accurate location may consume more power and may take longer.

Parameters
`accuracy`	`int`: Value is `NO_REQUIREMENT`, `ACCURACY_FINE`, or `ACCURACY_COARSE`

Throws
`IllegalArgumentException`	if accuracy is not one of the supported constants

setAltitudeRequired

public void setAltitudeRequired (boolean altitudeRequired)

Indicates whether the provider must provide altitude information. Not all fixes are guaranteed to contain such information.

Parameters
`altitudeRequired`	`boolean`

setBearingAccuracy

public void setBearingAccuracy (int accuracy)

Indicates the desired bearing accuracy. Accuracy may be ACCURACY_LOW, ACCURACY_MEDIUM, ACCURACY_HIGH, or NO_REQUIREMENT. More accurate location may consume more power and may take longer.

Parameters
`accuracy`	`int`: Value is `NO_REQUIREMENT`, `ACCURACY_LOW`, `ACCURACY_MEDIUM`, or `ACCURACY_HIGH`

Throws
`IllegalArgumentException`	if accuracy is not one of the supported constants

setBearingRequired

public void setBearingRequired (boolean bearingRequired)

Indicates whether the provider must provide bearing information. Not all fixes are guaranteed to contain such information.

Parameters
`bearingRequired`	`boolean`

setCostAllowed

public void setCostAllowed (boolean costAllowed)

Indicates whether the provider is allowed to incur monetary cost.

Parameters
`costAllowed`	`boolean`

setHorizontalAccuracy

public void setHorizontalAccuracy (int accuracy)

Indicates the desired horizontal accuracy (latitude and longitude). Accuracy may be ACCURACY_LOW, ACCURACY_MEDIUM, ACCURACY_HIGH or NO_REQUIREMENT. More accurate location may consume more power and may take longer.

Parameters
`accuracy`	`int`: Value is `NO_REQUIREMENT`, `ACCURACY_LOW`, `ACCURACY_MEDIUM`, or `ACCURACY_HIGH`

Throws
`IllegalArgumentException`	if accuracy is not one of the supported constants

setPowerRequirement

public void setPowerRequirement (int powerRequirement)

Indicates the desired maximum power requirement. The power requirement parameter may be NO_REQUIREMENT, POWER_LOW, POWER_MEDIUM, or POWER_HIGH.

Parameters
`powerRequirement`	`int`: Value is `NO_REQUIREMENT`, `POWER_LOW`, `POWER_MEDIUM`, or `POWER_HIGH`

setSpeedAccuracy

public void setSpeedAccuracy (int accuracy)

Indicates the desired speed accuracy. Accuracy may be ACCURACY_LOW, ACCURACY_MEDIUM, ACCURACY_HIGH, or NO_REQUIREMENT. More accurate location may consume more power and may take longer.

Parameters
`accuracy`	`int`: Value is `NO_REQUIREMENT`, `ACCURACY_LOW`, `ACCURACY_MEDIUM`, or `ACCURACY_HIGH`

Throws
`IllegalArgumentException`	if accuracy is not one of the supported constants

setSpeedRequired

public void setSpeedRequired (boolean speedRequired)

Indicates whether the provider must provide speed information. Not all fixes are guaranteed to contain such information.

Parameters
`speedRequired`	`boolean`

setVerticalAccuracy

public void setVerticalAccuracy (int accuracy)

Indicates the desired vertical accuracy (altitude). Accuracy may be ACCURACY_LOW, ACCURACY_MEDIUM, ACCURACY_HIGH or NO_REQUIREMENT. More accurate location may consume more power and may take longer.

Parameters
`accuracy`	`int`: Value is `NO_REQUIREMENT`, `ACCURACY_LOW`, `ACCURACY_MEDIUM`, or `ACCURACY_HIGH`

Throws
`IllegalArgumentException`	if accuracy is not one of the supported constants

toString

public 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())

Returns
`String`	a string representation of the object.

writeToParcel

public void writeToParcel (Parcel parcel, 
                int flags)

Flatten this object in to a Parcel.

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.PARCELABLE_WRITE_RETURN_VALUE`. Value is either `0` or a combination of `Parcelable.PARCELABLE_WRITE_RETURN_VALUE`, and android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES