de.infoware.android.mti.GPS Class Reference

Static Public Member Functions
static native int	setGpsModeSendToServer (boolean doSendToServer)
static native int	setOdometry (double meters, boolean relative, boolean setPosition)
static native int	sendGpsData (double latitude, double longitude, double height, double speedInKmh, double heading, int numberOfSatellites, int quality, GpsMsgType messageType, int timeYear, int timeMonth, int timeDay, int timeHour, int timeMinute, int timeSecond, int timeMilliSecond)
static void	addListener (GPSListener listener)
static void	removeListener (GPSListener listener)
static void	removeAllListeners ()

Detailed Description

Member Function Documentation

addListener()

static void de.infoware.android.mti.GPS.addListener ( GPSListener  listener )

static

removeAllListeners()

static void de.infoware.android.mti.GPS.removeAllListeners ( )

static

removeListener()

static void de.infoware.android.mti.GPS.removeListener ( GPSListener  listener )

static

sendGpsData()

static native int de.infoware.android.mti.GPS.sendGpsData ( double  latitude, double  longitude, double  height, double  speedInKmh, double  heading, int  numberOfSatellites, int  quality, GpsMsgType  messageType, int  timeYear, int  timeMonth, int  timeDay, int  timeHour, int  timeMinute, int  timeSecond, int  timeMilliSecond  )

static

If GPS mode is set to GPS.setGpsModeSendToServer() (true) is called before, this method can be used to send GPS data to the server. F.e. if only one GPS receiver is accessible per application, the data can be distributed in that way.

Parameters

latitude	- latitude in decimal degrees
longitude	- longitude in decimal degrees
height	- height in meters
speedInKmh	- speed in km/h
heading	- heading in degrees
numberOfSatellites	- number of satellites
quality	- quality
messageType	- 1, if the GPS data originates from GGA/RMC 2, only RMC was evaluated. height and sat is invalid
timeYear	- Format YYYY
timeMonth	- Format MM - 1 - 12
timeDay	- Format DD - day of month
timeHour	- 0 - 23
timeMinute	- 0 - 59
timeSecond	- 0 - 59
timeMilliSecond	- Not used

Returns

• if > 0 unique Id of the request,
• ApiError.MESSAGE_NOT_SEND if the communication to the server does not work
• ApiError.NOT_INITIALIZED if Api.init() was not called before
• ApiError.WRONG_PARAM if a given parameter is not in the valid range
• ApiError.QUEUE_LIMIT_EXCEEDED if the interface has received the max amount of messages without processing them

Invokes callback GPSListener.sendGpsDataResult().

setGpsModeSendToServer()

static native int de.infoware.android.mti.GPS.setGpsModeSendToServer ( boolean  doSendToServer )

static

This functions allows to deactivate the servers GPS receiver and indicates that the server will receive GPS information from the client application via the method GPS.sendGpsData(). Especially if only a single GPS receiver is available, this function can be used to specify how the data shall be distributed.

If the parameter is set to true, no further GPSListener.onGps() will be received until the mode is set to false (default setting).

Parameters

doSendToServer

- False if the server uses the GPS receiver and provides GPS data via the callback GPSListener.onGps() True if the server does NOT use the GPS receiver. The client application has to send the GPS info to the server by invoking GPS.sendGpsData(). The client should call this method once per second.

Returns

• if > 0 unique Id of the request,
• ApiError.MESSAGE_NOT_SEND if the communication to the server does not work
• ApiError.NOT_INITIALIZED if Api.init() was not called before
• ApiError.QUEUE_LIMIT_EXCEEDED if the interface has received the max amount of messages without processing them

Invokes callback GPSListener.setGpsModeSendToServerResult().

setOdometry()

static native int de.infoware.android.mti.GPS.setOdometry ( double  meters, boolean  relative, boolean  setPosition  )

static

Sets the current odometry of a vehicle. It is set in absolute meters or in relative meters, traveled since the previous call. If setNewPosition is true and if there is a current route guidance, a new position is generated by the odometry.

Returns

Errorcode

• ApiError.OK if successful
• ApiError.NO_ROUTE if setNewPosition is true with no route.
• ApiError.MAPMATCHING if setNewPosition is true with route, but no current matched position on it.
• ApiError.WRONG_PARAM if the subsequent call to this function lead to negative odometry
• ApiError.QUEUE_LIMIT_EXCEEDED if the interface has received the max amount of messages without processing them

Invokes callback GPSListener.setOdometryResult().