×
Namespaces

Variants
Actions
(Difference between revisions)

HERE Maps API - How to draw a polygon

From Nokia Developer Wiki
Jump to: navigation, search
hamishwillee (Talk | contribs)
m (Hamishwillee - Automated change of category from Ovi Maps to Nokia Maps)
avnee.nathani (Talk | contribs)
(Avnee.nathani - Updated article for Nokia Maps Javascript API v2.0. (Released in Dec 2011))
Line 1: Line 1:
 
[[Category:Web]][[Category:Browser]][[Category:Nokia Maps]]
 
[[Category:Web]][[Category:Browser]][[Category:Nokia Maps]]
 +
{{Abstract|visible=false|This article explains how to draw a polygon on Nokia Maps}}
 +
 +
{{ArticleMetaData
 +
|platform= Web browser
 +
|update-by=[[User:avnee.nathani]]
 +
|update-timestamp=20111231
 +
}}
 +
 
==Introduction==
 
==Introduction==
  
In this article we will see how to draw a polygon on Ovi Maps.
+
In this article we will see how to draw a polygon on Nokia Maps.
  
 
==Prerequisites==
 
==Prerequisites==
  
Ovi Maps API supported web browser (basically any modern web browser)
+
Nokia Maps API supported web browser (basically any modern web browser)
  
 
==Important about Maps credentials==
 
==Important about Maps credentials==
  
With Ovi Maps API you can start without having any credentials given, but you might face a performance gap. In order to get the full potential out of the  
+
With Nokia Maps API you can start without having any credentials given, but you might face a performance gap. In order to get the full potential out of the  
 
offering, you must get the credentials that authenticate your application against the Services. Please read through the Location API.
 
offering, you must get the credentials that authenticate your application against the Services. Please read through the Location API.
  
For more information on how to obtain the credentials, please start with the  Ovi Maps API Developers Guide section "Acquiring API credentials"
+
For more information on how to obtain the credentials, please start with the  Nokia Maps API Developers Guide section "Acquiring API credentials"
  
 
==Implementation==
 
==Implementation==
Line 20: Line 28:
  
 
<code java>
 
<code java>
     new ovi.mapsapi.map.Polygon (path, props)  
+
     new nokia.maps.map.Polygon (path, props)  
 
      
 
      
     ovi.mapsapi.geo.Strip | ovi.mapsapi.geo.Coordinate[]}    path    The path as coordinate strip.
+
     nokia.maps.geo.Strip | nokia.maps.geo.Coordinate[]}    path    The path as coordinate strip.
     ovi.mapsapi.map.Polygon.Properties}                      props    The initial values of the specified properties.  
+
     nokia.maps.map.Polygon.Properties}                      props    The initial values of the specified properties.  
 
</code>
 
</code>
  
 
To draw the Polygon we will create a new geo Strip with Coordinates and then a new Polygon will be instantiated using it. The Properties are defined
 
To draw the Polygon we will create a new geo Strip with Coordinates and then a new Polygon will be instantiated using it. The Properties are defined
 
the same way for drawing a Circle, Polyline or a Polygon.
 
the same way for drawing a Circle, Polyline or a Polygon.
 
  
 
==Example code==
 
==Example code==
Line 36: Line 43:
 
<html>
 
<html>
 
<head>
 
<head>
    <script src="http://api.maps.ovi.com/jsl.js" type="text/javascript" charset="utf-8">
+
<script type="text/javascript"
    </script>
+
    src="http://api.maps.nokia.com/2.0.0/jsl.js" charset="utf-8">
 +
</script>
 
       <link rel="stylesheet" href="style.css" />
 
       <link rel="stylesheet" href="style.css" />
 
</head>
 
</head>
Line 44: Line 52:
 
</body>
 
</body>
 
<script type="text/javascript">
 
<script type="text/javascript">
 
+
 
+
myGeoStrip = new ovi.mapsapi.geo.Strip([52,13,100,48,2,100,48,16,100,52,13,100], "values lat lng alt");
+
myGeoStrip = new nokia.maps.geo.Strip([52,13,100,48,2,100,48,16,100,52,13,100], "values lat lng alt");
 
+
var map = new ovi.mapsapi.map.Display(document.getElementById("map"),  // new instance of Ovi Maps
+
var map = new nokia.maps.map.Display(document.getElementById("map"),  // new instance of Ovi Maps
 
{
 
{
 
+
     components: [ new ovi.mapsapi.map.component.Behavior(),
+
     components: [ new nokia.maps.map.component.Behavior(),
                 new ovi.mapsapi.map.component.ZoomBar(),
+
                 new nokia.maps.map.component.ZoomBar(),
                 new ovi.mapsapi.map.component.Overview(),                             
+
                 new nokia.maps.map.component.Overview(),                             
                 new ovi.mapsapi.map.component.TypeSelector(),     
+
                 new nokia.maps.map.component.TypeSelector(),     
                 new ovi.mapsapi.map.component.ScaleBar()],
+
                 new nokia.maps.map.component.ScaleBar()],
 
     'zoomLevel': 4,  
 
     'zoomLevel': 4,  
 
     'center':[53.1, 13.1]
 
     'center':[53.1, 13.1]
 
});
 
});
 
+
 
map.set("baseMapType", map.SATELLITE);
 
map.set("baseMapType", map.SATELLITE);
 
+
//new ovi.mapsapi.map.Polygon (path, props)  
+
//new nokia.maps.map.Polygon (path, props)  
 
/*
 
/*
{ovi.mapsapi.geo.Strip | ovi.mapsapi.geo.Coordinate[]}    path      The path as coordinate strip.
+
{nokia.maps.geo.Strip | nokia.maps.geo.Coordinate[]}    path      The path as coordinate strip.
{ovi.mapsapi.map.Polygon.Properties}                      props      The initial values of the specified properties.  
+
{nokia.maps.map.Polygon.Properties}                      props      The initial values of the specified properties.  
 
*/
 
*/
 
+
 
+
 
map.objects.add(
 
map.objects.add(
     new ovi.mapsapi.map.Polygon(myGeoStrip,  
+
     new nokia.maps.map.Polygon(myGeoStrip,  
 
     {  
 
     {  
 
             precision: 36,
 
             precision: 36,
 
           simplify: 16,
 
           simplify: 16,
 
           fillColor: "FFFFCC",
 
           fillColor: "FFFFCC",
           color: "E8FA75",
+
           color: "#829f",
 
           width: 8
 
           width: 8
 
     }));
 
     }));
 
+
 
</script>
 
</script>
 
</body>
 
</body>
Line 84: Line 92:
 
</code>
 
</code>
  
==For more on Ovi Maps API==
 
  
Please check out the Ovi Maps API full documentation and API reference here:
+
==For more on Nokia Maps API==
  
http://api.maps.ovi.com
+
Please check out the Nokia Maps API full documentation and API reference here:
 +
* http://api.maps.nokia.com/2.0.0
  
 +
You may also access the interactive Nokia Maps API playground,
 +
* http://api.maps.nokia.com/playground/index.html
 
==Tested with==
 
==Tested with==
  
Google Chrome 11.0x
+
* Google Chrome 11.0x
 
+
* Mozilla Firefox 5.0b
Mozilla Firefox 5.0b
+

Revision as of 12:45, 31 December 2011


Article Metadata
Compatibility
Platform(s): Web browser
Article
Created: (31 Dec 2011)
Updated: avnee.nathani (31 Dec 2011)
Last edited: avnee.nathani (31 Dec 2011)

Contents

Introduction

In this article we will see how to draw a polygon on Nokia Maps.

Prerequisites

Nokia Maps API supported web browser (basically any modern web browser)

Important about Maps credentials

With Nokia Maps API you can start without having any credentials given, but you might face a performance gap. In order to get the full potential out of the offering, you must get the credentials that authenticate your application against the Services. Please read through the Location API.

For more information on how to obtain the credentials, please start with the Nokia Maps API Developers Guide section "Acquiring API credentials"

Implementation

The API definition:

    new nokia.maps.map.Polygon (path, props) 
 
nokia.maps.geo.Strip | nokia.maps.geo.Coordinate[]} path The path as coordinate strip.
nokia.maps.map.Polygon.Properties} props The initial values of the specified properties.

To draw the Polygon we will create a new geo Strip with Coordinates and then a new Polygon will be instantiated using it. The Properties are defined the same way for drawing a Circle, Polyline or a Polygon.

Example code

<html>
<head>
<script type="text/javascript"
src="http://api.maps.nokia.com/2.0.0/jsl.js" charset="utf-8">
</script>
<link rel="stylesheet" href="style.css" />
</head>
<body>
<div id="map" style="width:100%; height:80%;"></div>
</body>
<script type="text/javascript">
 
 
myGeoStrip = new nokia.maps.geo.Strip([52,13,100,48,2,100,48,16,100,52,13,100], "values lat lng alt");
 
var map = new nokia.maps.map.Display(document.getElementById("map"), // new instance of Ovi Maps
{
 
components: [ new nokia.maps.map.component.Behavior(),
new nokia.maps.map.component.ZoomBar(),
new nokia.maps.map.component.Overview(),
new nokia.maps.map.component.TypeSelector(),
new nokia.maps.map.component.ScaleBar()],
'zoomLevel': 4,
'center':[53.1, 13.1]
});
 
map.set("baseMapType", map.SATELLITE);
 
//new nokia.maps.map.Polygon (path, props)
/*
{nokia.maps.geo.Strip | nokia.maps.geo.Coordinate[]} path The path as coordinate strip.
{nokia.maps.map.Polygon.Properties} props The initial values of the specified properties.
*/

 
 
map.objects.add(
new nokia.maps.map.Polygon(myGeoStrip,
{
precision: 36,
simplify: 16,
fillColor: "FFFFCC",
color: "#829f",
width: 8
}));
 
</script>
</body>
</html>


For more on Nokia Maps API

Please check out the Nokia Maps API full documentation and API reference here:

You may also access the interactive Nokia Maps API playground,

Tested with

  • Google Chrome 11.0x
  • Mozilla Firefox 5.0b
171 page views in the last 30 days.
×