es.situm.sdk.v1

Class SitumIPSManager

java.lang.Object

es.situm.sdk.v1.SitumIPSManager

Deprecated.

Use LocationManager

public final class SitumIPSManager
extends Object

Manage Situm's Indoor Positioning Service

Constructor Summary

Constructors

Constructor and Description
SitumIPSManager(android.content.Context context) Deprecated. use LocationManager instead

Method Summary

Modifier and Type	Method and Description
void	adjustLocationToRoute(List<SitumFloorPoint> route) Deprecated. Use NavigationManager instead
boolean	changeBuilding(SitumBuilding building) Deprecated. use LocationManager.requestLocationUpdates(LocationRequest, LocationListener) from LocationManager instead
long	getID() Deprecated. use SitumSdk.getDeviceID() instead
String	getPositioningaddress() Deprecated. debug method no longer supported
boolean	isAdjustingLocation() Deprecated. Use NavigationManager instead
boolean	isRunning() Deprecated. use LocationManager.isRunning() from LocationManager instead
void	reset() Deprecated. use LocationManager.removeUpdates(LocationListener) and then LocationManager.requestLocationUpdates(LocationRequest, LocationListener) instead
void	setMagAccuracyReceiver(SitumMagAccuracyListener receiver) Deprecated. no longer supported
void	setMotionReceiver(SitumMotionReicever receiver) Deprecated. no longer supported
void	setPoseReceiver(SitumPoseReceiver receiver) Deprecated. use LocationManager.requestLocationUpdates(LocationRequest, LocationListener) from LocationManager instead
void	setSensorErrorListener(SitumSensorErrorListener sensorErrorListener) Deprecated. use LocationManager.requestLocationUpdates(LocationRequest, LocationListener) from LocationManager instead
void	start(SitumBuilding building) Deprecated. use LocationManager.requestLocationUpdates(LocationRequest, LocationListener) from LocationManager instead
void	start(SitumBuilding building, boolean usewifi, boolean useble, boolean usemag) Deprecated. use LocationManager.requestLocationUpdates(LocationRequest, LocationListener) from LocationManager instead
void	start(SitumBuilding building, SitumPositioningOptions options) Deprecated. use LocationManager.requestLocationUpdates(LocationRequest, LocationListener) from LocationManager instead
void	stop() Deprecated. use LocationManager.removeUpdates(LocationListener) from LocationManager instead
void	stopAdjustingLocation() Deprecated. Use NavigationManager instead
boolean	useBle(boolean value) Deprecated. use LocationManager.requestLocationUpdates(LocationRequest, LocationListener) from LocationManager instead
boolean	useCompass(boolean value) Deprecated. no longer supported. Is always true
boolean	useMag(boolean value) Deprecated. no longer supported. Is always true
boolean	useWifi(boolean value) Deprecated. use LocationManager.requestLocationUpdates(LocationRequest, LocationListener) from LocationManager instead
boolean	usingBLE() Deprecated. no longer supported. Use LocationManager.requestLocationUpdates(LocationRequest, LocationListener) and check LocationRequest object
boolean	usingCompass() Deprecated. no longer supported. Is always true
boolean	usingMag() Deprecated. is always true
boolean	usingWifi() Deprecated. no longer supported. Use LocationManager.requestLocationUpdates(LocationRequest, LocationListener) and check LocationRequest object

Methods inherited from class java.lang.Object

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

Constructor Detail

SitumIPSManager

public SitumIPSManager(android.content.Context context)

Deprecated. use LocationManager instead

Create a manager for the postioning service

Parameters:

context - Application that will run the positioning service

Method Detail

getID

public long getID()

Deprecated. use SitumSdk.getDeviceID() instead

Get the ID from this device.

Returns:

the device ID. If the ID is not valid it will return Utils#INVALID_DEVICE_ID

start

public void start(SitumBuilding building,
                  SitumPositioningOptions options)

Deprecated. use LocationManager.requestLocationUpdates(LocationRequest, LocationListener) from LocationManager instead

Start the positioning service for a given building.

If the building does not have a valid positioning service it show a message and service does not initialize. We can pass to this method a SitumPositioningOptions with custom values for the positioning service, for example when to use wifi, ble or mag.

Now we can pass to the options that we can simulate positions. With this option we can develop without wifi or ble.

If building is null then throw an IllegalArgumentException, and the positioning is not started, equal for options

Parameters:

building - Building where we want to estimate our position

options - Options for the positioning system

See Also:

SitumPositioningOptions

start

public void start(SitumBuilding building)

Deprecated. use LocationManager.requestLocationUpdates(LocationRequest, LocationListener) from LocationManager instead

Start the positioning service for a given building. This for default create a SitumPositioningOptions with all sensors enabled

If the building does not have a valid positioning service it show a message and service does not initialize.

If building is null then throw an IllegalArgumentException and the positioning is not possible

Parameters:

building - building to start positioning

start

@Deprecated
public void start(SitumBuilding building,
                              boolean usewifi,
                              boolean useble,
                              boolean usemag)

Deprecated. use LocationManager.requestLocationUpdates(LocationRequest, LocationListener) from LocationManager instead

Start the positioning service for the given building.

If the building does not have a valid positioning service it show a message and service does not initialize

Parameters:

building - Building where we want to estimate our position

usewifi - Use wifi to estimate the position

useble - Use beacons to estimate the position

usemag - Use magnetic field anomalies to estimate the position

stop

public void stop()

Deprecated. use LocationManager.removeUpdates(LocationListener) from LocationManager instead

Stop the positioning service IMPORTANT NOTICE: this method should be called when application closes or is moved to background to avoid unnecesary battery and data usage

changeBuilding

public boolean changeBuilding(SitumBuilding building)

Deprecated. use LocationManager.requestLocationUpdates(LocationRequest, LocationListener) from LocationManager instead

Change building while running

Parameters:

building - Supply a new building to start the positioning server

Returns:

true if the change was correctly made, false otherwise

getPositioningaddress

public String getPositioningaddress()

Deprecated. debug method no longer supported

Obtain the positioning url and port for the current SitumBuilding. The current building is the active positioning building. This method only return valid values when the developer options are enabled, if this setting is not enabled this method return an empty string

Returns:

url:port or empty string

adjustLocationToRoute

public void adjustLocationToRoute(List<SitumFloorPoint> route)

Deprecated. Use NavigationManager instead

Adjust the future locations received to the route. This improves the precision of the location in the navigation mode

Parameters:

route - the route

stopAdjustingLocation

public void stopAdjustingLocation()

Deprecated. Use NavigationManager instead

Stop the adjustment of the locations to a route

isAdjustingLocation

public boolean isAdjustingLocation()

Deprecated. Use NavigationManager instead

Returns:

true if the locations are been adjusted to a route, false otherwise

isRunning

public boolean isRunning()

Deprecated. use LocationManager.isRunning() from LocationManager instead

Check if the SitumService is running and requesting positions

Returns:

true if the service is running, false otherwise

reset

public void reset()

Deprecated. use LocationManager.removeUpdates(LocationListener) and then LocationManager.requestLocationUpdates(LocationRequest, LocationListener) instead

Resets the positioning service to start estimating the positioning from scratch

setPoseReceiver

public void setPoseReceiver(SitumPoseReceiver receiver)

Deprecated. use LocationManager.requestLocationUpdates(LocationRequest, LocationListener) from LocationManager instead

Sets the SitumPoseReceiver callback to receive the pose data.

Parameters:

receiver - Callback that is asynchronously called when new pose data is received

setMotionReceiver

public void setMotionReceiver(SitumMotionReicever receiver)

Deprecated. no longer supported

Sets the SitumMotionReicever callback to receive the motion data

Parameters:

receiver - Callback that is asynchronously called when new motion information is received

setMagAccuracyReceiver

public void setMagAccuracyReceiver(SitumMagAccuracyListener receiver)

Deprecated. no longer supported

Sets the SitumMagAccuracyListener callback to receive the magnetic field accuracy data

Parameters:

receiver - Callback that is asynchronously called when new motion data is received

setSensorErrorListener

public void setSensorErrorListener(SitumSensorErrorListener sensorErrorListener)

Deprecated. use LocationManager.requestLocationUpdates(LocationRequest, LocationListener) from LocationManager instead

Sets the callback to receive the status of the sensors and device connectivity

Parameters:

sensorErrorListener - SitumSensorErrorListener

useWifi

public boolean useWifi(boolean value)

Deprecated. use LocationManager.requestLocationUpdates(LocationRequest, LocationListener) from LocationManager instead

Active/deactivate the use of wifi information for positioning

Parameters:

value - Use wifi information for positioning

Returns:

true if the value is successfully changed, false otherwise

useBle

public boolean useBle(boolean value)

Deprecated. use LocationManager.requestLocationUpdates(LocationRequest, LocationListener) from LocationManager instead

Active/deactivate the use of ble information for positioning

Parameters:

value - Use ble information for positioning

Returns:

true if the value is successfully changed, false otherwise

useMag

public boolean useMag(boolean value)

Deprecated. no longer supported. Is always true

Active/deactivate the use of magnetic field information for positioning

Parameters:

value - Use magnetic field information for positioning

Returns:

true if the value is successfully changed, false otherwise

useCompass

public boolean useCompass(boolean value)

Deprecated. no longer supported. Is always true

Active/deactivate the use of compass information for positioning

Parameters:

value - Use compass information for positioning

Returns:

true if the value is successfully changed, false otherwise

usingWifi

public boolean usingWifi()

Deprecated. no longer supported. Use LocationManager.requestLocationUpdates(LocationRequest, LocationListener) and check LocationRequest object

Check if wifi information is being used for postioning

Returns:

true if using wifi information, false otherwise

usingBLE

public boolean usingBLE()

Deprecated. no longer supported. Use LocationManager.requestLocationUpdates(LocationRequest, LocationListener) and check LocationRequest object

Check if ble information is being used for postioning

Returns:

true if using ble information, false otherwise

usingCompass

public boolean usingCompass()

Deprecated. no longer supported. Is always true

Check if compass information is being used for postioning

Returns:

true if using compass information, false otherwise

usingMag

public boolean usingMag()

Deprecated. is always true

Check if magnetic field information is being used for postioning

Returns:

true if using magnetic field information, false otherwise