LocationResult

  • LocationResult is a data class representing a geographic location result from the fused location provider.

  • Locations returned are guaranteed to have valid latitude, longitude, and UTC timestamp, and on API level 17+, elapsed real-time since boot.

  • The class provides methods to create a LocationResult, extract it from an Intent, get the latest location, or retrieve all locations.

  • You can check if an Intent contains a LocationResult using the hasResult method.
public final class LocationResult extends Object
implements Parcelable

A data class representing a geographic location result from the fused location provider.

All locations returned by getLocations() are guaranteed to have a valid latitude, longitude, and UTC timestamp. On API level 17 or later they are also guaranteed to have elapsed real-time since boot. All other parameters are optional.

Inherited Constant Summary

Field Summary

public static final Creator<LocationResult> CREATOR

Public Method Summary

static LocationResult
create(List<Location> locations)
Creates a LocationResult for the given locations.
boolean
equals(Object o)
static LocationResult
extractResult(Intent intent)
Extracts the LocationResult from an Intent.
Location
getLastLocation()
Returns the most recent location available in this result, or null if no locations are available.
List<Location>
getLocations()
Returns locations computed, ordered from oldest to newest.
static boolean
hasResult(Intent intent)
Returns true if an Intent contains a LocationResult.
int
hashCode()
String
toString()
void
writeToParcel(Parcel parcel, int flags)

Inherited Method Summary

Fields

public static final Creator<LocationResult> CREATOR

Public Methods

public static LocationResult create (List<Location> locations)

Creates a LocationResult for the given locations.

public boolean equals (Object o)

public static LocationResult extractResult (Intent intent)

Extracts the LocationResult from an Intent.

This is a utility function which extracts the LocationResult from the extras of an Intent that was sent from the fused location provider.

Returns

public Location getLastLocation ()

Returns the most recent location available in this result, or null if no locations are available.

public List<Location> getLocations ()

Returns locations computed, ordered from oldest to newest.

No duplicate locations will be returned to any given listener (i.e. locations will not overlap in time between subsequent calls to a listener).

public static boolean hasResult (Intent intent)

Returns true if an Intent contains a LocationResult.

This is a utility function that can be called from inside an intent receiver to make sure the received intent is from the fused location provider.

Returns

public int hashCode ()

public String toString ()

public void writeToParcel (Parcel parcel, int flags)