com.nokia.mid.location
Class LocationUtil

java.lang.Object
  com.nokia.mid.location.LocationUtil

public final class LocationUtil

extends java.lang.Object

Method Summary

static LocationProvider

getLocationProvider(int[] preferredMethods, java.lang.String parameters) Get a LocationProvider matching defined location methods.

Methods inherited from class java.lang.Object

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

Method Detail

getLocationProvider

public static LocationProvider getLocationProvider(int[] preferredMethods,
                                                   java.lang.String parameters)
                                            throws java.lang.SecurityException,
                                                   LocationException

Get a LocationProvider matching defined location methods. Preferred methods are defined by using definitions in javax.microedition.location.Location. Possible methods:

• (MTA_ASSISTED | MTE_CELLID | MTE_SHORTRANGE | MTY_NETWORKBASED) - Online CellID and/or WLAN
• (MTA_ASSISTED | MTE_SATELLTITE | MTY_TERMINALBASED) - Assisted GPS
• (MTA_UNASSISTED | MTE_SATELLITE | MTY_TERMINALBASED) - Standalone GPS
• (MTA_UNASSISTED | MTE_CELLID | MTY_TERMINALBASED) - Offline CellID

Parameters:

preferredMethods - The preferred location methods, if null behaves as LocationProvider.getInstance(null).

parameters - Reserved for future bearer selection.

Returns:

A LocationProvider matching the preferred location methods and/or platform specific parameters. Null if a LocationProvider that meets the defined conditions can't be found but there are other available or temporarily unavailable providers that do not support the defined conditions.

Throws:

SecurityException, - LocationException

java.lang.SecurityException

LocationException