This library defines the HERE Maps API for Java ME, explains its purpose, summarizes its features and outlines how it supports third-party application development.
The HERE Maps API for Java ME is a set of programming interfaces that enable developers to build mobile device applications based on HERE Maps. The API 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.
The simplest map you can create with this API is a zoomable and pannable map that uses default settings. You can change its look and behavior, and add overlays with custom content. Through custom MapComponents, the API allows you to implement handling for touch and keypress events, which in turn allows users to interact with the displayed content.
The main features offered by the Maps API for Java ME are summarized in the table below:
|Maps||Display maps of any location in the world and in satellite, terrain and hybrid. You can enrich the map with custom content such as Markers and Polylines.|
|Searches||With the help of the places search service, the API supports local search and places look-up by category; use this functionality to find places matching a given free text such as 'restaurant' in a defined area. Your application receives (and can display) detailed information about relevant places, including contact details, opening times and reviews.|
|Geocoding/Reverse Geocoding||The API's built-in search manager generates location-based search results, using text search criteria. Provide a street address to obtain the geographic coordinates, or retrieve an address by supplying the geo coordinates as input for the search.|
|Routing||The routing service gives your application the ability to calculate and render routes between any start and end point, taking into consideration transport and traffic preferences.|
|Custom items||The API allows you to add standard markers or create custom ones, using any Image resource. You can also add geo shapes based on coordinates to the map: polygons, polylines, circles or rectangles. Through the use of MapComponents you can make these custom map object interactive.|
|Touch Suppport||The API allows the end user to pan and zoom the map using touch by default. It is also possible for a developer to extend the basic touch support through creating MapComponents which respond directly to touch events.|
|Sharing||Build a location sharing facility into your app. Let your users send map images to one another. The API includes integration with other Nokia products offering a mechanism to embed a location URL in an SMS message, where the receiving user can view the location on the map.|
|KML||Integrate KML assets from other sources – parse and import previously created geospatial data and show the content on the map without having to recreate it manually.|
This API is designed to work with any devices supporting the following Java Technologies: Java Specification Request (JSR) 139 Connected, Limited Device Configuration (CLDC) 1.1 and Mobile Information Device Profile (MIDP) 2.0, JSR 118 or higher.
The HERE Maps API for Java ME is modular and contains separate packages for maps, places, touch components, directions (routing) and KML data rendering. If an application does not require certain packages, you can reduce its size by excluding them.
|Library JAR Name||Description|
|maps-core.jar||This JAR is required for all map-based applications.|
|maps-components.jar||This JAR offers a series of custom MapComponents (such as Infobubbles) and creates a framework for touchable MapComponents, such as buttons.|
|maps-gesture.jar||This JAR extends the maps-components.jar to add gesture support to the MapComponents. The device must support the Gesture API 1.2 or higher.|
|maps-kml.jar||This JAR (along with an implementation of JSR-172) is required to process and display KML data.|
|places.jar||This JAR is required to access the places, geocoding, reverse geocoding and the sharing functions.|
|routing.jar||This JAR is required to access the routing service.|
The HERE Maps API for Java ME is free to use under the HERE Maps API terms and conditions and subject to limitations set out on the pricing plans page: http://developer.here.net/web/guest/plans. This site also outlines alternative licensing options for developers.
Please note that the use of any of the HERE Location Platform APIs must be accompanied by authentication credentials. For information on how to obtain and use the credentials, please see Acquiring Credentials.
Last updated 21 January 2014