oracle.panama.mp
Interface Positioner

public interface Positioner

Positioner interface. An application uses Positioner interface to request mobile device position.

Method Summary

PositionResult	requestPosition(java.lang.String mobileID) Request position of a mobile target.
PositionResult[]	requestPosition(java.lang.String[] mobileIDs) Request position information of a number of mobile targets.
PositionResult[]	requestPosition(java.lang.String[] mobileIDs, PositioningQoS pqos) Request position information of a number of mobile targets.
PositionResult	requestPosition(java.lang.String mobileID, PositioningQoS pqos) Request position information of a mobile target.

Method Detail

requestPosition

public PositionResult requestPosition(java.lang.String mobileID)
                               throws MPException

Request position of a mobile target. If the request succeeds, then a PositioneResult object is returned. If an error occurs it throws an MPException. Please note that a PositioneResult may be an error result. You need to check error code of a PositioneResult before accessing other information.

Parameters:

mobileID - The mobile target's ID.

Returns:

A PositionResult object.

Throws:

MPException

requestPosition

public PositionResult[] requestPosition(java.lang.String[] mobileIDs)
                                 throws MPException

Request position information of a number of mobile targets. If the request succeeds, then a PositioneResult object is returned. If error occurs it throws an MPException. Please note that a PositioneResult may be an error result. You need to check error code of a PositioneResult before accessing other information.

Parameters:

mobileIDs - A String array representing the mobile IDs.

Returns:

PositionResult[] A array of PositionResult objects.

Throws:

MPException

requestPosition

public PositionResult[] requestPosition(java.lang.String[] mobileIDs,
                                        PositioningQoS pqos)
                                 throws MPException

Request position information of a number of mobile targets. If the request succeeds, then a PositioneResult object is returned. If error occurs it throws an MPException.

Parameters:

mobileIDs - A String array representing the mobile targets' IDs.

Returns:

PositionResult[] A array of PositionResult objects.

Throws:

MPException

requestPosition

public PositionResult requestPosition(java.lang.String mobileID,
                                      PositioningQoS pqos)
                               throws MPException

Request position information of a mobile target. If the request succeeds, then a PositioneResult object is returned. If error occurs it throws an MPException. Please note that a PositioneResult may be an error result. You need to check error code of a PositioneResult before accessing other information.

Parameters:

mobileID - The mobile target's ID.

Returns:

A PositionResult object.

Throws:

MPException