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.



Copyright © 2003-2008 Nokia Corporation. All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.