×
Namespaces

Variants
Actions
(Difference between revisions)

Using the RESTful Map API together with HERE Maps API

From Nokia Developer Wiki
Jump to: navigation, search
jasfox (Talk | contribs)
m (Jasfox - RESTful Map API and links.)
jasfox (Talk | contribs)
m (Jasfox - Update Metadata.)
Line 67: Line 67:
 
{{ArticleMetaData
 
{{ArticleMetaData
 
|platform= Web
 
|platform= Web
|capabilities= Nokia Maps
+
|capabilities= <!-- Capabilities required by the article/code example (e.g. Location, NetworkServices. -->
 
|keywords= Nokia Maps, JavaScript, Map Image
 
|keywords= Nokia Maps, JavaScript, Map Image
 
|dependencies=Nokia Maps 2.2.0
 
|dependencies=Nokia Maps 2.2.0
 +
|devices= Internet Explorer, Google Chrome , Firefox, Opera
 
|review-by=<!-- After re-review: [[User:username]] -->
 
|review-by=<!-- After re-review: [[User:username]] -->
 
|review-timestamp=<!-- After re-review: YYYYMMDD -->
 
|review-timestamp=<!-- After re-review: YYYYMMDD -->

Revision as of 09:42, 11 April 2012

In short the Nokia Maps APIs allow you to integrate Nokia maps into your web pages. The Nokia Maps API offers a variety of essential map functionality out of the box like, panning, zooming and support for W3C positioning inbuilt in modern browsers. However in some situations it is just enough to show the map image. This is where the RESTful Map API comes into play.

The RESTful Map API is light weight, but full-blown, offering for easy access of map data. Map data is served as a single image, which makes it highly compatible with variety of devices. You don’t even need JavaScript so show the map.

To maximize the compatibility and to potentially reduce initial page load time, you can combine these two APIs. JavaScript is not supported on some browsers of mobile devices, which is not an optimal situation if you are creating content for a mobile friendly website. One way to circumvent this problem is by having a plain map image served up on the page initially. Then only after the user clicks on the map the interactive Map is loaded. In this way you can potentially save on initial load time and be reassured that all of your visitors are able to see the map.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8" />
<meta http-equiv="X-UA-Compatible" content="IE=7; IE=EmulateIE9" />
<title>RESTful Map API Image with Nokia Map API for JavaScript</title>
<!-- No additional support required here. -->
<script type="text/javascript" charset="UTF-8" src="http://api.maps.nokia.com/2.2.0/jsl.js"></script>
<script type="text/javascript">
/*<![CDATA[*/
/////////////////////////////////////////////////////////////////////////////////////
// Don't forget to set your API credentials
//
// Replace with your appId and token which you can obtain when you
// register on http://api.developer.nokia.com/
//
nokia.Settings.set( "appId", "YOUR APP ID GOES HERE");
nokia.Settings.set( "authenticationToken", "YOUR AUTHENTICATION TOKEN GOES HERE");
//
/////////////////////////////////////////////////////////////////////////////////////
/*]]>*/
</script>
<script type="text/javascript">
function showFullMap(){
var mapContainer = document.getElementById("mapContainer");
mapContainer.innerHTML = "";
// Create a map inside the map container DOM node
var map = new nokia.maps.map.Display(mapContainer, {
zoomLevel: 4, //zoom level for the map
center: [50.5,15.5], // center coordinates
components : [
new nokia.maps.map.component.ZoomBar(),
new nokia.maps.map.component.Behavior(),
new nokia.maps.map.component.TypeSelector(),
new nokia.maps.map.component.Overview(),
new nokia.maps.map.component.ScaleBar()]
});
}
</script>
</head>
<body>
<div id="mapContainer" style="width:540px; height:334px;">
<img src="http://m.nok.it/?c=50.5,15.5&amp;h=334&amp;w=540&amp;z=4&amp;nord&amp;nodot&amp;sb=k&amp;appId=YOUR APP ID GOES HERE&amp;token=YOUR AUTHENTICATION TOKEN GOES HERE" onclick="showFullMap();" alt="Map of Europe" />
</div>
</body>
</html>

Note.pngNote: In the example above, the following RESTful Map API parameters have been set to match the definition of the dynamic Nokia Map

  • c - Centre Point 50.5° latiitude 15.5 ° longitude
  • h - Height 334 pixels, same as the height style of the map container <div>
  • w - width 540 pixels, same as the width style of the map contasiner <div>
  • z - zoom level 4, same as the map.
  • nord, nodot, sb - The image should not attempt to redirect, no dot is rfequired over the centre point and a scale bar is required.
  • appId and token - standard authentication parameters

Article Metadata
Tested with
Devices(s): Internet Explorer, Google Chrome , Firefox, Opera
Compatibility
Platform(s): Web
Dependencies: Nokia Maps 2.2.0
Article
Keywords: Nokia Maps, JavaScript, Map Image
Created: isalento (17 Jan 2011)
Updated: jasfox (05 Jan 2012)
Last edited: jasfox (11 Apr 2012)
230 page views in the last 30 days.