com.veriplace.client
Class LocationMode

java.lang.Object
  com.veriplace.client.LocationMode

public class LocationMode
extends java.lang.Object

Constants representing the allowable location modes. These can be used with GetLocationAPI methods that take a LocationOptions parameter.

See Also:

Veriplace Developer Guide: Using the Get Location API - Location Modes

Field Summary

static java.lang.String	AREA An approximate location request with lower latency and cost.
static java.lang.String	FREEDOM A request that queries previously cached locations, and will never trigger a new GPS fix.
static java.lang.String	ZOOM A high-accuracy request that may have higher latency and cost.

Constructor Summary

LocationMode()

Method Summary

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

ZOOM

public static final java.lang.String ZOOM

A high-accuracy request that may have higher latency and cost.

See Also:

Constant Field Values

AREA

public static final java.lang.String AREA

An approximate location request with lower latency and cost.

See Also:

Constant Field Values

FREEDOM

public static final java.lang.String FREEDOM

A request that queries previously cached locations, and will never trigger a new GPS fix. This location mode is free of charge until you reach a high per-month request volume; after that point, it will fail with a GetLocationBillingDeclinedException if your developer account does not have a positive balance.

For Veriplace-enabled smartphones, an attempt to generate a new cached location occurs at regular intervals. A new location is also generated if a different application locates the same user using an on-demand mode (ZOOM or AREA).

If you make a FREEDOM mode request when you have already queried the most recent location and there isn't yet a new location, you will get a PositionFailureException, whose PositionFailureException.getCachedLocation() method will return the most recent cached location. To suppress this exception and just get the most recent location at all times, you can configure the Client with a custom LocationFilter, or, more simply, set the property DefaultClientFactory.USE_LAST_KNOWN_LOCATION to "true".

See Also:

Constant Field Values

Constructor Detail

LocationMode

public LocationMode()