net.rim.device.api.gps
Class GPSSettings

java.lang.Object
  |
  +--net.rim.device.api.gps.GPSSettings

public class GPSSettings

extends Object

Provides access to the device's Global Positioning System receiver (if equipped).

Since:

JDE 4.2.0

Method Summary

static boolean

setPDEInfo(String ip, int port) Set the given PDE IP and port for the device.

Methods inherited from class java.lang.Object

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

Method Detail

setPDEInfo

public static boolean setPDEInfo(String ip,
                                 int port)
                          throws IllegalArgumentException

Set the given PDE IP and port for the device. Some carriers require the third party appilications to call this method with correct ip and port values before they can use the Location API. Third party application developers are expected to contact the carrier to obtain the PDE IP and port values.

Parameters:

ip - address to be set for PDE

port - to be set for the PDE

Returns:

true if the ip and port values are valid, false otherwise.

Throws:

UnsupportedOperationException - if a non-CDMA device tries to invoke this method.

IllegalArgumentException - If the ip address string is not in correct format

NullPointerException - If ip is null

Since:

JDE 4.2.0