Runtime environment notes

System properties

Property	Value
microedition.location.version	Returns the version string if Location API is supported on the device. Otherwise returns null.
fileconn.dir.landmarks	Returns the location of JSR-179 landmarks store in the file system.
fileconn.dir.landmarks.name	Returns localised name for the landmarks store.

Localisation and direct access directories

There is no user interface (UI) and no localised texts. Location API for J2ME (JSR-179) does not directly access any directories.

Security

The Location API implementation uses MIDP 2.0 security. The permissions defined in the Location API are grouped to the following Function groups:

**Table:** The permissions defined in the Location API
Permission name	Function Group
javax.microedition.location.Location	Location
javax.microedition.location.ProximityListener	Location
javax.microedition.location.LandmarkStore.read	Landmark
javax.microedition.location.LandmarkStore.write	Landmark
javax.microedition.location.LandmarkStore.category	Landmark
javax.microedition.location.LandmarkStore.management	Landmark

The policy for these function groups for the different domains is defined below. The table below contains all the allowed settings for the function groups.

**Table:** User settings for Location and Landmark function groups
Function group	Trusted 3rd party domain	Untrusted domain
Location	Default setting: Session Allowed settings: Blanket, Session, Oneshot, No	Default setting: Oneshot Allowed settings: Session, Oneshot, No
Landmark	Default setting: Session Allowed settings: Blanket, Session, Oneshot, No	Default setting: Oneshot Allowed settings: Session, Oneshot, No

Explanations for the table values are as follows:

“Blanket” is valid for every invocation of an API by a MIDlet suite until it is uninstalled or the permission is changed by the user.
“Session” is valid from the invocation of a MIDlet suite until it terminates. “Session” mode MUST prompt the user on or before the first invocation of the API or function, which is protected. When the user re-invokes the MIDlet suite the prompt MUST be repeated.
“No” means that the MIDlet can’t access the protected function at all.
"Oneshot" is valid for a single invocation of an API by a MIDlet suite and must prompt the user every time when the API or a protected function is invocated.