Location API for Java ME: Difference between revisions

Revision as of 00:20, 13 December 2006

Latest revision as of 23:20, 8 July 2022

(34 intermediate revisions by 18 users not shown)

Line 1:

{{Short description|Physical ___location application interface}}

The '''Location API''', is a specification defining an optional [[Application programming interface|API]] package for communicating with [[GPS]] devices using the [[Java programming language|Java]]. It extends the capabilities of the [[Java Platform, Micro Edition]], a version of the [[Java platform]] tailored for [[embedded device]]s such as [[mobile phone]]s and [[Personal digital assistant|PDA]]s. The [[Object-oriented programming|object-oriented]] interface consists of 13 [[Class (computer science)|classes]] in the javax.microedition.___location package. The Location API was developed under the [[Java Community Process]] as JSR 179 released September 2003 and updated to version 1.0.1 March 2006. [[Nokia]] is the main author and maintainer of this JSR.

The '''Location API for Java ME''' is a compact and generic [[Java Platform, Micro Edition|Java 2 ME]] [[Application Programming Interface|API]] that produces information about the device's present physical ___location to Java applications. This API can be optionally supported by [[mobile phone]] and [[Personal digital assistant|PDA]] manufacturers, with the minimum Java platform required for this API being [[Connected Limited Device Configuration|CLDC v1.1]].

The Location API was developed under the [[Java Community Process]] as JSR 179, released in September 2003 and updated to version 1.0.1 in March 2006. [[Nokia]] is the main author and maintainer of this [[Java Specification Request|JSR]].

== Goals of Location API ==

'''OpenLAPI''' is an [[LGPL]] implementation for use in emulator environments where the Nokia reference implementation does not exist and for devices which can access a [[GPS]] device over [[Bluetooth]].

Previously, ___location service implementations were provider specific. The aim of this API was to provide a common API for retrieving the ___location information on a variety of devices.

== Current stateFeatures ==

The Location API is designed to work with many different positioning methods. Generic interfaces lets application developers implement systems that can retrieve ___location data from multiple sources, based on their availability on the device. It has advantages over a single means of tracking, including fail-over, indoor/outdoor transparency, and a choice between the speed and accuracy trade-offs between [[Global Positioning System|GPS]], cellular, or other positioning methods. The API supports:<ref>[http://www.ddj.com/java/184406388 Dr. Dobb's 2006 - The Java Location API]</ref>

*Current ___location - current [[latitude]], [[longitude]], [[altitude]], [[Direction (geometry)|direction]], and [[speed]] of the phone, and methods to convert it to [[Geographic_coordinate#Degrees:_a_measurement_of_angle|text]].

*Landmark proximity - a store of landmarks can be stored on the phone's memory, and the current ___location can be added as a landmark.

*Address data - the nearest landmark's textual details, such as postal address, phone number, country, and the building and its URL.<ref>[http://www.ddj.com/showArticle.jhtml?documentID=ddj0601i&pgno=8 Dr. Dobb's 2006 - The Java Location API - Address Information]</ref>

*Location listeners - for dynamic ___location-based applications that will be triggered by when the current ___location changes.

The Location API does not support:

*Topological data - which is usually derived from the shapes of cell site coverage.

*Location-based queries - although the current ___location of the device can be calculated.

== Device independence ==

Previously, ___location service implementations were provider specific. The aim of this API was to provide a common API for retrieving the ___location information on a variety of devices.

OpenLAPI supports several back-ends:

* GPS over [[Bluetooth]]

* [[National Marine Electronics Association|NMEA]] logfile (for development)

* KML ([[Keyhole Markup Language]]) (for development)

* random entry from a persistent landmark store (for development)

along with device specific wrappers.

== Support ==

Since many providers choose not to implement this optional JSR, the goal of universality has still not happened and developers are often required to create custom builds for different devices.

The Location API is available to Java applications on some [[BlackBerry]] and [[Windows Mobile]] devices, recent [[Motorola]] and [[Sony Ericsson]] devices, and all [[Nokia]] [[S60 (software platform)|Series 60 3rd Edition]] devices.

== External links ==

== References ==

* [http://www.jcp.org/en/jsr/detail?id=179] (JSR 179: Location API for J2METM)

<references/>

== External links ==

* [httphttps://www.jcp.org/en/jsr/detail?id=179] (JSR 179: Location API for J2METM)J2ME]

[[Category:Java device platform]]

[[Category:Java specification requests]]

[[Category:ApplicationKeyhole programmingMarkup interfacesLanguage]]

[[Category:Java APIs]]