The HERE Maps API for Java ME is a set of programming interfaces, allowing you to develop mobile device applications based on HERE Maps. The API, which has been integrated as a plug-in into the Noka Asha SDK, provides mapping, search, and routing functionality and targets devices that support the Mobile Information Device Profile (MIDP) for Java Micro Edition, such as Nokia Asha and Series 40 devices. Furthermore, although these demos have been written to be used with the latest Asha Platform, they are fully backwards compatible with older series 40 phones.
This project consists of the source code and video demonstrations of a series of custom map components using the HERE Maps API for Java ME plugin. The examples are meant to show how to extend the basic map functionality to use the additional capabilities of full youch phones.
Java Technology (JSR) 139 Connected, Limited Device Configuration (CLDC) 1.1 and Mobile Information Device Profile (MIDP) 2.0, JSR 118 devices.
Tested on Nokia Asha 311 and Nokia Asha 501. Developed with Netbeans 7.1 and Nokia Asha SDK 1.0.
Before starting, please acquire a set of API Credentials from the API Registration page at Forum Nokia and register your application for free. See Using Access Credentials.
Please read through the Location API Business Models and Usage Restrictions page so that you can decide which business model fits your needs best. The page is located at http://developer.here.com/plans.
There are fifteen MIDlets that are contained in the example project. These are Minimal Map Example, Map Type Example, Search Example, Marker Example, Custom Marker Example, Routing Example, Cached Map Example, Place Search, Share My Map, Tweets On My Map, and KML Data Example.
The examples were created using !NetBeans 7.1 and Nokia Asha SDK 1.0. The project can be easily opened in NetBeans by selecting 'Open Project' from the File menu and selecting the application.
To install the application on a phone, transfer the file
MapsAPIExamples.jar to the phone via Nokia Suite or via Bluetooth. The examples demonstrate the following features:
The following MIDlets demonstrate the use of custom components as found in the
MapObjectis moved to the center of the screen, an event is fired in the
MapObjectis pressed, the map state is altered to bring it to the center of the map.
MapComponentresponding to the Long Press event from the Gesture API.
GestureMapCanvasresponding to the Pinch event by zooming the map. Use of the
GestureMapCanvasrequires the presence of the Gesture API.
Click on the video below to see each of the custom Map Components in action.
More information is available at http://developer.here.com/java.
RouteFeaturesare not supported with the route calculations.
Several other fully functional demos are also available which combine the use of the various examples described with touch components to provide a complete application. Click on the demos below to see a series on how Touchable Map Components can be added to an existing application.
A demonstration of an enhancement to the standard KML Example offered as part of the HERE Maps API for Java ME. The demo has been optimised to use the features available on Full Touch Phones, such as the Asha 311.
The Default Cursor and Download Indicator have been removed as unnecessary, and replaced with the Centerer Component. Tooltips have also been added to offer visual feedback to the User prior to making a selection.
A demonstration of an enhancement to the standard Places Example offered as part of the HERE Maps API for Java ME. The demo has been optimised to use the features available on Full Touch Phones, such as the Asha 311.
The Default Cursor and Download Indicator have been removed as unnecessary, and replaced by a Centering Component and a Focal Observer. Whenever a
MapObject is found at the centre of the screen the Place data is displayed using either an Infobubble or a Context Menu depending upon whether contact details can be found. The visual feedback means that the user is always offered the correct control to touch or make a further choice.
A demonstration of an enhancement to the standard Routing Example offered as part of the HERE Maps API for Java ME. The demo has been optimised to use the features available on Full Touch Phones, such as the Asha 311.
The Default Cursor and Download Indicator have been removed as unnecessary and replaced by a Centering Component. Map Markers are added using the Long Press Gesture, and additional Actions have been hidden away using a Side bar component. The side bar copies the look-and-feel of the draggable handle familiar from the virtual keyboard interface and reveals a series of touchable icons.