intro to apps with maps for series 40

Application Development with Nokia Maps and Location APIs for Series 40

Nokia Series 40

1 © Nokia 2012 Intro to Maps on Apps.pptx

Jason Fox Technical Support Engineer Maps Platform

1. Introduction to Nokia Maps API for Java ME

2. Getting Started - Prerequisites 3. Basic Mapping Concepts 4. An Introduction to the Search and

Routing Services 5. An Introduction to positioning (JSR-179)

Agenda


Nokia Maps API for Java ME


What is Nokia Maps API for Java ME?


Full details at : http://www.developer.nokia.com/Develop/Maps/Maps_API_for_Java_ME/

• API aimed at Series 40 Phones. Allows you to develop mobile applications based on Nokia Maps.

• Façade Pattern - hides all the “plumbing” code - the low level connection calls, image manipulation etc.

• Targets devices supporting MIDP 2.0 or higher.

• Not currently part of the SDK

• Single downloadable JAR around 150 kB.

• Faster App development. Better App performance

http://www.developer.nokia.com/Develop/Maps/Maps_API_for_Java_ME/�

Why use Nokia Maps API for Java ME?


• Multiple map types optimised for mobile displays

• Low latency and reduced network traffic compared with static map image solutions.

• “Out-of-the box” support for common mapping use cases (Markers, Images, Polygons, Polylines, Pan and Zoom)

• In-built libraries to access search, routing and POI information services.

• Map Components are open to extension -

ability to customise and override standard API functionality.

• Advanced Features as standard, such as KML parsing and the addition of custom overlays

Comparison of Nokia Maps for Java ME vs. Static Map Image Solutions


Static Map (e.g. RESTful Map API) • one single http request per map ->one single image returned in response • new request for each alteration. Maps for Java ME • multiple http requests for individual map tiles. • Map tiles are cached. • Map tiles stitched together and objects

added to display result on screen • Additional requests only made if necessary.

Result • Reduced latency and lowered network traffic though built-in intelligent

map rendering, caching and tiling = Better for Mobile.

Prerequisites


Prerequisites


1. Install a Java Runtime Environment 6 http://www.java.com/en/download/index.jsp

2. Install an IDE (e.g. NetBeans) Netbeans.org

3. Install a Nokia SDK for Java (free) http://www.developer.nokia.com/Develop/Java/Tools/

http://www.java.com/en/download/index.jsp�

http://www.developer.nokia.com/Develop/Java/Tools/�



2.

Prerequisites


4. Configure Nokia SDK in NetBeans

1.

3.

Prerequisites


5. Download the binary Jar http://www.developer.nokia.com/Develop/Maps/Maps_API_for_Java_ME/Getting_started/

http://www.developer.nokia.com/Develop/Maps/Maps_API_for_Java_ME/Getting_started/�

Prerequisites


6. Register as a developer free at www.developer.nokia.com

Prerequisites


7. Obtain a free set of authentication credentials (App Id and Token) from: https://api.developer.nokia.com/ovi-api/ui/registration − A unique App ID and Token, are required for each application

8. After creating a new NetBeans project, You must add a reference to the Nokia Maps API binary jar itself - Maps_API.jar. This reference is added under the ”Resources” folder in theNetBeans project.

https://api.developer.nokia.com/ovi-api/ui/registration�

https://api.developer.nokia.com/ovi-api/ui/registration�

Basic Mapping Concepts


• The Minimal Map

• An Introduction to Map Types

• Map Languages

• Markers

• Polylines and Polygons

• Interaction

The Minimal Map


A Pannable Zoomable Map in five lines of code 1. Set credentials in the ApplicationContext

2. Create a MapCanvas

3. Set it as the current Display

Map Types


Pick the right map type for your app

Map Types – Simple Method


The Standard Map Schemes

The Code

Map Types – Advanced Method


1) Implement a MapSchemeListener and call getAvailableMaps()

2) Handle Success and Failure

3) Set the BaseMapType from MapProviders received

Map Languages


• Currently eight map Languages available Arabic, Chinese, German, English, French, Italian, Russian and Spanish

• Just set the DefaultLanguage in the ApplicationContext

• By default Maps are displayed in English

Map Markers


Markers highlight points of interest at a specified location on the map - two types exist: • MapStandardMarker

• Various Geometric Shapes plus Balloon • Easy to add text, change color (and opacity)

• MapMarker • Used to add graphical icons. • Need to define an anchor point.

• Use the MapFactory to created instances of MapStandardMarkers and MapMarkers

• Default marker is a ‘Nokia Blue’ Balloon

Polylines and Polygons


• A MapPolyline is a series of connected points

• A MapPolygon is the area within a closed loop of points

• Every instance of a MapPolygon or MapPolyline is created using the MapFactory

• Both objects have an implicit GeoBoundingBox.

MapCanvas MapDisplay MapObject


• MapCanvas holds a MapFactory and a MapDisplay

• Use the MapFactory to create MapObjects

• Can also use MapFactory to create

a MapDisplay directly e.g. for automatic caching of Static Maps

• The MapDisplay contains MapObjects but is also a

MapObject itself.

• MapObjects may be also be contained within a MapContainer

Map Events


• Create a MapComponent to interact with your MapDisplay

• Add an EventListener to your MapComponent to receive notifications of screen interactions and key presses

An Introduction to Location-Based Services


• Search (Geocoding and Reverse Geocoding)

• Places Search

• Routing

• Sharing

Geocoding Search


• Finds a location on the Map from a given Address

• Search can be either synchronous or asynchronous.

• Asynchronous search is preferred.

1. Implement a GeoCodeRequestListener

2. Create a GeoCodeRequest

3. Handle Success or Failure

Reverse Geocoding Search


• Finds the Address for a given geographic location. • Search can be either synchronous or asynchronous. • Asynchronous search is preferred.

1. Implement a ReverseGeocodeRequestListener

2. Create a ReverseGeoCodeRequest


Places Search


• Flexible Local Search • General Text Search (e.g. “Pizza”) • Category Search (e.g. restaurant) • Combined Search (e.g. “Italian” + restaurant)

• Drill down to get more details

• Contact Details • Opening Times • Description and Reviews • Images etc.

Places Search


1. Implement a PlaceSearchRequestListener

2. Create a PlaceSearchRequest


4. More details can be obtained by interrogating the Result

Routing Service


• Routing Service consists of creating a route between two or more Waypoints.

• Responses from the Routing service can take time. Make your RouteRequests asynchronously.

1. Implement a RouteListener

2. Create a RouteRequest


• Routing Type – default is RoutingType.Shortest

• Mode of Transport – default is TransportMode.CAR

• Additional Restrictions – None are selected by default

Routing Service


• The preferred route calculation can be optimized by altering the parameters of the RoutingMode

Sharing Manager


• Creates short encrypted URLs for the RESTful Maps API

• Send URL as an SMS for a client to receive a static map.

• Service forwards to maps.nokia.com or m.maps.nokia.com on capable browsers

Positioning


• Separate Optional Package for Positioning (JSR-179)

• Frequently combined with the Nokia Maps API for Java ME, though not part of the API itself

• Two location methods maybe available • Cell ID positioning • GPS

Cell-ID Location


• A MIDlet can obtain an approximate position using the Cell-ID location method.

• The method consists of passing the ID of the cell the device is currently connected to, on to a look-up service. The service will then return the well-known position of the given cell-ID.

• This Cell ID location provides a method of positioning mobile devices which do not contain a GPS unit.

Note: the degree of uncertainty can vary of a few meters to hundreds of kilometers, depending upon the infrastructure of the local network and the data available to the look-up service for that region

Cell-ID Example

1) Create a Cell-ID LocationProvider using LocationUtils Note: The second parameter of getLocationProvider() is currently always null. This leaves the library open for future extension

2) Make a call to getLocation() and process the result

The attributes of the QualifiedCoordinate class map directly onto the GeoCoordinate class.

Set up a loop and poll to obtain location updates.

© Nokia 2012 Intro to Maps on Apps.pptx 33

LocationUtil • The preferred Location method(s) can

be any combination of the methods defined in JSR-179:

Useful Combinations • Offline Cell ID

• Standalone GPS

• Assisted GPS

• Online Cell ID an/or WLAN


GPS Example

1. Create a GPS LocationProvider

2. Set the provider to start polling

3. Retrieve and process the result


For More Information

Download the latest Nokia SDK for Java http://developer.nokia.com Consult the Nokia Developer Library http://library.developer.nokia.com Nokia Maps API http://developer.nokia.com/Maps


intro to apps with maps for series 40

Technology

comparison of nokia

use nokia maps api

nokia series

nokia maps api binary

nokia sdk

prerequisites7 nokia

nokia blue balloon19

english18 nokia