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 localized name for the landmarks store.

Localization and direct access directories

There is no user interface (UI) and no localized 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 75:** The permissions defined in the Location API
Permission name	Function Group
`javax.microedition.location.Location`	Location
`javax.microedition.location.Orientation`	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 76:** User settings for Location and Landmark function groups
Function group	Manufacturer domain	Operator domain	Trusted 3rd party domain	Untrusted domain
Location	Default setting: Blanket Allowed settings: Blanket	Default setting: Blanket Allowed settings: Blanket	Default setting: Session Allowed settings: Blanket, Session, Oneshot, No	Default setting: Oneshot Allowed settings: Session, Oneshot, No
Landmark	Default setting: Blanket Allowed settings: Blanket	Default setting: Blanket Allowed settings: Blanket	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.