LocationFence

public final class LocationFence extends Object

This class is deprecated.
The Awareness API is deprecated and will be turned down in a future Google Play services release, as early as January 2027. There is no direct replacement.

Use this class to create location-based fences.

Note: Values that indicate a changing state are momentarily FenceState.TRUE for about 5 seconds, then automatically revert to FenceState.FALSE.

Public Method Summary

static AwarenessFence
entering(double latitude, double longitude, double radius)
This method is deprecated. The Awareness API is deprecated and will be turned down in a future Google Play services release, as early as January 2027. There is no direct replacement.
static AwarenessFence
exiting(double latitude, double longitude, double radius)
This method is deprecated. The Awareness API is deprecated and will be turned down in a future Google Play services release, as early as January 2027. There is no direct replacement.
static AwarenessFence
in(double latitude, double longitude, double radius, long dwellTimeMillis)
This method is deprecated. The Awareness API is deprecated and will be turned down in a future Google Play services release, as early as January 2027. There is no direct replacement.

Inherited Method Summary

Public Methods

public static AwarenessFence entering (double latitude, double longitude, double radius)

This method is deprecated.
The Awareness API is deprecated and will be turned down in a future Google Play services release, as early as January 2027. There is no direct replacement.

This fence is momentarily (about 5 seconds) in the FenceState.TRUE state when the user enters the specified circle.

To use this method, your app must declare the android.permission.ACCESS_FINE_LOCATION permission in AndroidManifest.xml, and the user must provide consent at runtime.

Parameters
latitude Center latitude of the circle in degrees, between -90 and +90 inclusive.
longitude Center longitude of the circle in degrees, between -180 and +180 inclusive.
radius Radius defining the circular region, in meters.
Returns

public static AwarenessFence exiting (double latitude, double longitude, double radius)

This method is deprecated.
The Awareness API is deprecated and will be turned down in a future Google Play services release, as early as January 2027. There is no direct replacement.

This fence is momentarily (about 5 seconds) in the FenceState.TRUE state when the user exits the specified circle.

Your app must declare the android.permission.ACCESS_FINE_LOCATION permission in your AndroidManifest and be granted this permission to use this API.

Parameters
latitude center latitude of the circle in degrees, between -90 and +90 inclusive
longitude center longitude of the circle in degrees, between -180 and +180 inclusive
radius radius in meters defining the circular region.
Returns

public static AwarenessFence in (double latitude, double longitude, double radius, long dwellTimeMillis)

This method is deprecated.
The Awareness API is deprecated and will be turned down in a future Google Play services release, as early as January 2027. There is no direct replacement.

This fence is in the FenceState.TRUE state when the user's location is within the specified circle, and the user has been in the circle for at least the dwellTimeMillis that was specified.

To use this method, your app must declare the android.permission.ACCESS_FINE_LOCATION permission in AndroidManifest.xml, and the user must provide consent at runtime.

Parameters
latitude Center latitude of the circle in degrees, between -90 and +90 inclusive.
longitude Center longitude of the circle in degrees, between -180 and +180 inclusive.
radius Radius defining the circular region, in meters.
dwellTimeMillis Minimum dwelling time inside a location before the fence is in the FenceState.TRUE state. Must be a value greater than or equal to 0L.
Returns