×
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 - add monospacing.)
Oskar Bukolt (Talk | contribs)
m (Oskar Bukolt - Update JS Lib + API Link + minor text alteration)
Line 1: Line 1:
 
[[Category:Code Snippet]][[Category:Nokia Maps]][[Category:JavaScript]][[Category:HTTP]]
 
[[Category:Code Snippet]][[Category:Nokia Maps]][[Category:JavaScript]][[Category:HTTP]]
 
In short the Nokia Maps APIs allow you to integrate Nokia maps into your web pages.  
 
In short the Nokia Maps APIs allow you to integrate Nokia maps into your web pages.  
The [http://api.maps.nokia.com/ 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.
+
The [http://api.maps.nokia.com/ Nokia Maps API] offers a variety of essential map functionality out of the box like, panning, zooming and support for W3C positioning built in to 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.
 
However in some situations it is just enough to show the map image. This is where the RESTful Map API comes into play.
  
 
The [http://api.maps.nokia.com/en/restmaps/overview.html 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.  
 
The [http://api.maps.nokia.com/en/restmaps/overview.html 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.  
+
To maximize the compatibility and to potentially reduce initial page load time, you can combine these two APIs. JavaScript is not supported on some mobile devices browsers which is not ideal 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.  
 
<code javascript>
 
<code javascript>
 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
Line 15: Line 15:
 
  <title>RESTful Map API Image with Nokia Map API for JavaScript</title>
 
  <title>RESTful Map API Image with Nokia Map API for JavaScript</title>
 
  <!-- No additional support required here. -->
 
  <!-- 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" charset="UTF-8" src="http://api.maps.nokia.com/2.2.1/jsl.js"></script>
 
  <script type="text/javascript">
 
  <script type="text/javascript">
 
/*<![CDATA[*/
 
/*<![CDATA[*/
Line 68: Line 68:
 
|platform= Web
 
|platform= Web
 
|capabilities= <!-- Capabilities required by the article/code example (e.g. Location, NetworkServices. -->
 
|capabilities= <!-- Capabilities required by the article/code example (e.g. Location, NetworkServices. -->
|keywords= Nokia Maps, JavaScript, Map Image
+
|keywords= Nokia Maps, JavaScript, Map Image, RESTful
|dependencies=Nokia Maps 2.2.0
+
|dependencies=Nokia Maps 2.2.1
 
|devices= Internet Explorer, Google Chrome , Firefox, Opera
 
|devices= Internet Explorer, Google Chrome , Firefox, Opera
 
|review-by=<!-- After re-review: [[User:username]] -->
 
|review-by=<!-- After re-review: [[User:username]] -->
Line 80: Line 80:
 
{{SeeAlso|
 
{{SeeAlso|
 
*  [http://api.maps.nokia.com/en/restmaps/overview.html RESTful Map API]
 
*  [http://api.maps.nokia.com/en/restmaps/overview.html RESTful Map API]
*  [http://api.maps.nokia.com/ Nokia Maps API]
+
*  [http://api.maps.nokia.com/en/maps/intro.html Nokia Maps API]
 
* [[Nokia Maps API - Advanced Routing|Using Map Image Turnpoints and Junction Views with Nokia Maps API ]]
 
* [[Nokia Maps API - Advanced Routing|Using Map Image Turnpoints and Junction Views with Nokia Maps API ]]
 
}}
 
}}

Revision as of 18:37, 16 July 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 built in to 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 mobile devices browsers which is not ideal 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.1/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° latitude 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 container <div>
  • z - zoom level 4, same as the map.
  • nord, nodot, sb - The image should not attempt to redirect, no dot is required 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.1
Article
Keywords: Nokia Maps, JavaScript, Map Image, RESTful
Created: isalento (17 Jan 2011)
Updated: jasfox (05 Jan 2012)
Last edited: Oskar Bukolt (16 Jul 2012)
292 page views in the last 30 days.

Was this page helpful?

Your feedback about this content is important. Let us know what you think.

 

Thank you!

We appreciate your feedback.

×