Package javax.microedition.location

Contains the basic classes needed to request and get a location result.

See:
Description

Interface Summary

AreaListener	This interface represents a listener to events associated with crossing the boundary of the given geographical area.
ExchangeFormatHandler	This interface provides methods to exchange landmarks.
LandmarkStoreListener	This interface represents a listener that receives events associated with changes in the landmark store.
LocationListener	The LocationListener represents a listener that receives events associated with a particular LocationProvider.
ProximityListener	Deprecated. in 2.0, replaced by AreaListener

Class Summary

AddressInfo	The AddressInfo class holds textual address information about a location.
CircleGeographicArea	This class represents a circular geographical area on WGS 84 Ellipsoid (see reference [WGS84]).
Coordinates	The Coordinates class represents coordinates as latitude-longitude-altitude values.
Criteria	The criteria used for the selection of the location provider is defined by the values in this class.
ExchangeFormatFactory	This class provides a mechanism for applications to obtain instances of different ExchangeFormatHandler objects.
GeographicArea	This interface represents a geographical area on the surface on WGS 84 Ellipsoid (see reference [WGS84]).
Landmark	The Landmark class represents a landmark, such as a known location with a name.
LandmarkStore	The LandmarkStore class provides methods to store, delete and retrieve landmarks from a persistent landmark store.
Location	The Location class represents the standard set of basic location information.
LocationProvider	This is the starting point for applications using location information in this API and represents a source of the location information.
Orientation	The Orientation class represents the physical orientation of the terminal.
PolygonGeographicArea	This class represents a polygon geographical area on WGS 84 Ellipsoid (see reference [WGS84]).
QualifiedCoordinates	The QualifiedCoordinates class represents coordinates as latitude-longitude-altitude values that are associated with an accuracy value.
RectangleGeographicArea	This class represents a rectangular geographical area on WGS 84 Ellipsoid (see reference [WGS84]).

Exception Summary

LandmarkException	The LandmarkException is thrown when an error related to handling landmarks has occurred.
LocationException	The LocationException is thrown when a Location API specific error has occurred.

Package javax.microedition.location Description

Contains the basic classes needed to request and get a location result.

The LocationProvider class represents a module that is able to determine the location of the terminal. This may be implemented using any possible location method, for example, satellite based methods like GPS, cellular network based methods, short-range positioning methods like Bluetooth Local Positioning, etc. The implementation may also combine methods in various ways to get the optimal result.

The application can specify criteria for selecting the location provider and obtain a LocationProvider instance that is able to fulfil these criteria as closely as possible. By using the LocationProvider, the application can get Location objects representing the location of the terminal at the time of the measurement. The application can either request a single Location object or be periodically updated with new Location objects via a LocationListener implemented by the application.

The location is represented by the Location object that contains a QualifiedCoordinates object representing the geographical coordinates (latitude, longitude and altitude) and information about their accuracy, a timestamp and possibly information about the speed and course of the terminal. For some location methods, the Location object may also contain an AddressInfo object that includes textual address information, e.g. a street address.

The Location gives the accuracy of the coordinates as the radius of a circular area indicating the 68% confidence level. This implies that the actual location is within the circle defined by the returned point and radius at a probability of approximately 68%. The actual location may thus also be outside of the circle, which has to be taken into account when using the location information in applications.

This package also includes a database of landmarks. A landmark is a known physical location that is associated with a name representing that location for the end user. The user can store commonly used locations in the database. Examples of landmarks could be, for example, the user’s home, office, etc. The default landmark database must be shared between all Java applications and may be shared with other applications in the terminal, including native applications, so that the end user has a consistent user experience across all location based applications on the terminal.

New features in version 2.0

Importing and exporting landmark and global landmark categories have been added to version 2.0 to enable the exchange of landmarks between different terminals. With the landmark exchange the user is able export landmarks stored in the terminal to another terminal or to a computer and import new landmarks to the terminal or, for example, from a points of interests database. The global landmark categories guarantee interoperability with different terminals. These categories must be present in all Location API 2.0 compliant terminals and the global category names must be localized to improve the user experience.

Location API 2.0 also makes improvements to the Criteria object allowing priorities to be set for different criterion. Creating private landmark stores is also one of the new features in Location API 2.0.