How to use ProximityListener in Java ME - Revision history

Jasfox: Jasfox - switch cat

2013-04-25T07:34:31Z

Jasfox - switch cat

Skalogir: Skalogir - /* Overview */

2011-10-05T08:31:19Z

Skalogir - - Overview

Skalogir: Skalogir -

2011-10-05T08:29:54Z

Skalogir -

Skalogir: Skalogir -

2011-10-05T08:29:17Z

Skalogir -

Hamishwillee: Hamishwillee - Automated change of text from Forum Nokia to Nokia Developer. (Rebrand)

2011-06-22T11:41:05Z

Hamishwillee - Automated change of text from Forum Nokia to Nokia Developer. (Rebrand)

Hamishwillee: Hamishwillee - Bot fixing redirect link.(Moving links from forum.nokia.com TO developer.nokia.com)

2011-06-21T11:39:28Z

Hamishwillee - Bot fixing redirect link.(Moving links from forum.nokia.com TO developer.nokia.com)

Hamishwillee: Bot change of links to internal format.

2011-05-19T03:35:07Z

Bot change of links to internal format.

Hamishwillee: Move to correct Category:Location

2011-03-17T22:58:06Z

Move to correct Category:Location

Jarmlaht: /* Overview */

2010-06-16T06:55:23Z

Overview

Jarmlaht: /* Overview */

2010-06-16T06:51:37Z

Overview

@@ Line 1: / Line 1: @@
-[[Category:Java ME]][[Category:Location]][[Category:How To]][[Category:Code Examples]][[Category:Symbian^3]][[Category:Java Runtime 2.1 for Symbian]]
+[[Category:Java ME]][[Category:How To]][[Category:Code Examples]][[Category:Symbian^3]][[Category:Java Runtime 2.1 for Symbian]][[Category:Location_API_(JSR-179)]]
 ==Overview==
 The Location API (JSR-179) has been part of Java implementations in S60 devices since S60 3rd Edition and in Series 40 devices since Series 40 6th Edition. The API provides classes for getting coordinates from a GPS receiver and also for accessing the phone's Landmarks (for both viewing and editing). The ProximityListener is one of the Location API features, that is not mandatory. It has not been supported in Location API implementations in Nokia phones before Symbian^3 (JRT 2.1). At the moment (October 2011) it is not supported in Series 40 devices. The class represents a listener to events associated with detecting proximity to some registered coordinates.

@@ Line 1: / Line 1: @@
 [[Category:Java ME]][[Category:Location]][[Category:How To]][[Category:Code Examples]][[Category:Symbian^3]][[Category:Java Runtime 2.1 for Symbian]]
 ==Overview==
-The Location API (JSR-179) has been part of Java implementations in S60 devices since S60 3rd Edition and in Series 40 devices since Series 40 6th Edition. The API provides classes for getting coordinates from a GPS receiver and also for accessing the Landmark store (for viewing and editing landmarks). The ProximityListener is one of the Location API features, that is not mandatory. It has not been supported in Location API implementations in Nokia phones before Symbian^3 (JRT 2.1). At the moment (October 2011) it is not supported in Series 40 devices. The class represents a listener to events associated with detecting proximity to some registered coordinates.
+The Location API (JSR-179) has been part of Java implementations in S60 devices since S60 3rd Edition and in Series 40 devices since Series 40 6th Edition. The API provides classes for getting coordinates from a GPS receiver and also for accessing the phone's Landmarks (for both viewing and editing). The ProximityListener is one of the Location API features, that is not mandatory. It has not been supported in Location API implementations in Nokia phones before Symbian^3 (JRT 2.1). At the moment (October 2011) it is not supported in Series 40 devices. The class represents a listener to events associated with detecting proximity to some registered coordinates.
 The code sample below shows a simple way of registering a ProximityListener to a MIDlet:

@@ Line 343: / Line 343: @@
 {{ArticleMetaData
-|devices=C6-01
+|devices=C6-01, N8
 |sdk=[http://www.developer.nokia.com/Resources/Tools_and_downloads/Other/Symbian_SDKs/ Symbian^3 SDK 1.0]
 |platform= Since Symbian^3

@@ Line 1: / Line 1: @@
-[[Category:Java ME]][[Category:Location]]
+[[Category:Java ME]][[Category:Location]][[Category:How To]][[Category:Code Examples]][[Category:Symbian^3]][[Category:Java Runtime 2.1 for Symbian]]
 ==Overview==
-Location API (JSR-179) has been part of Java implementations in S60 devices since S60 3rd Edition and in Series 40 devices since Series 40 6th Edition. Basically it provides classes for getting coordinates from GPS and also for accessing Landmark store (for viewing and editing landmarks). ProximityListener is one of the Location API features, which is not mandatory, but whose availability depends on the used location method. It has not been supported in Location API implementations in Nokia phones before Symbian^3 (JRT 2.1). At the moment (June 2010) it is not supported in Series 40 devices. Basically it represents a listener to events associated with detecting proximity to some registered coordinates.
+The Location API (JSR-179) has been part of Java implementations in S60 devices since S60 3rd Edition and in Series 40 devices since Series 40 6th Edition. The API provides classes for getting coordinates from a GPS receiver and also for accessing the Landmark store (for viewing and editing landmarks). The ProximityListener is one of the Location API features, that is not mandatory. It has not been supported in Location API implementations in Nokia phones before Symbian^3 (JRT 2.1). At the moment (October 2011) it is not supported in Series 40 devices. The class represents a listener to events associated with detecting proximity to some registered coordinates.
-The code sample below shows a simple way of registering ProximityListener to coordinates:
+The code sample below shows a simple way of registering a ProximityListener to a MIDlet:
 <code java>
 try {
      provider = LocationProvider.getInstance(null);
      if (provider != null) {
          provider.setLocationListener(this, -1, -1, -1);
-        // midlet.target = coordinates of the target location
+         LocationProvider.addProximityListener(this, coordinates, proxRadius);
-        // midlet.radius = radius from the target coordinates,  proximityEvent() method is called, when this distance from the target is reached
-         LocationProvider.addProximityListener(this, midlet.target, midlet.radius);
+     }
-     else midlet.showError("Error", "LocationProvider = null!");
+     else
 } catch (LocationException le) {
-     midlet.showError("LocationException", "ProximityListener might not be supported: " + le.getMessage());
+     f.append("LocationException! "+"ProximityListener might not be supported: " + le.getMessage());
-    le.printStackTrace();
+}
 </code>
-In the code sample above also LocationListener is set. The example MIDlet (ProximityMIDlet) uses it for getting continuosly coordinates for ProximityListener for tracking the distance to the registered coordinates. Older Nokia devices (which don't have JRT 2.1) don't support ProximityListener. In this case the MIDlet will throw LocationException, when addProximityListener() method is called.
 ==Usage of the ProximityMIDlet==
@@ Line 32: / Line 39: @@
-The idea of the application is the select one of landmarks in the device for the target and then set the distance to it, when the ProximityListener is registered to notify the user. So, in order to use this application there must be at least one landmark in the device. They can be created for example by using Nokia Maps application, or they can be sent from other devices as multimedia message attachments.
+The idea of the application is to select one of the landmarks already saved in the device as the center point for registering the proximity listener. The user can set the distance from the center point within which proximity is defined. In order to use this application, there must be at least one saved landmark in the device. These can be easily created for example by using the Nokia Maps application, or they can be sent from other devices as multimedia message attachments.
-When the user reaches the distance of the radius from the selected landmark, an Alert is shown to the user. When the distance is reached, MIDlet calls ProximityListener.proximityEvent(Coordinates coordinates, Location location) method. Note, that the listener is called only once when the terminal enters the proximity of the registered coordinates. The registration with these coordinates is cancelled when the listener is called. If the application wants to be notified again about these coordinates, it must re-register the coordinates and the listener.
+When the user approaches the center point within the defined proximity distance, an Alert is shown to the user. The MIDlet then calls the proximityEvent method. Note, that the proximityEvent method is called only once when the terminal enters the proximity area of the registered coordinates. The proximity registration for these coordinates is cancelled as soon as the the proximityEvent is called. If the application should be notified again, a new ProximityListener registration is required.
 The images below show some screenshots from the MIDlet running in Nokia N8:
@@ Line 332: / Line 339: @@
 ==See also==
 * [[Java Location Articles|Java ME Location API articles in Nokia Developer wiki]]
-* [http://library.developer.nokia.com/topic/Java_Developers_Library/GUID-FC0BA9D0-B571-4378-880A-71F0723D2877.html ProximityListener in Java Developer's Library][[Category:How To]][[Category:Code Examples]]
+* [http://library.developer.nokia.com/topic/Java_Developers_Library/GUID-FC0BA9D0-B571-4378-880A-71F0723D2877.html ProximityListener in Java Developer's Library]
-[[Category:Symbian^3]][[Category:Java Runtime 2.1 for Symbian]]

@@ Line 331: / Line 331: @@
 ==See also==
-* [[Java Location Articles|Java ME Location API articles in Forum Nokia wiki]]
+* [[Java Location Articles|Java ME Location API articles in Nokia Developer wiki]]
 * [http://library.developer.nokia.com/topic/Java_Developers_Library/GUID-FC0BA9D0-B571-4378-880A-71F0723D2877.html ProximityListener in Java Developer's Library][[Category:How To]][[Category:Code Examples]]
 [[Category:Symbian^3]][[Category:Java Runtime 2.1 for Symbian]]