(Difference between revisions)

How to display a map using Polymaps JS library

From Nokia Developer Wiki
Jump to: navigation, search
r2j7 (Talk | contribs)
m (Removed Java ME tag since this article is about Web Runtime development (i.e. not about Java Runtime development))
hamishwillee (Talk | contribs)
m (Automated change of category from Web Runtime (WRT) to Symbian Web Runtime)
Line 1: Line 1:
[[Category:Web Runtime (WRT)]]
[[Category:Symbian Web Runtime]]

Revision as of 02:33, 13 April 2011



Polymaps is a JavaScript library for generating “slippy” maps in the style of Google Maps, Modest Maps, CloudMade and OpenLayers.

Most mapping libraries focus on 256×256-pixel image tiles, with only limited support for dynamic overlays such as county boundaries and point clouds. These libraries assume that data needed to produce the desired overlay can be loaded into memory all-at-once, making it difficult to visualize large datasets. Furthermore, while image tiles automatically adjust in resolution as the map zooms in or out, the overlay resolution remains constant; this greatly limits multi-scale exploration of data, as the resolution must be fixed either for macro- (e.g., state-level) or micro- (e.g., block-level) observation.

The goal of Polymaps is to better support rich, large-scale data overlays on interactive maps by extending the tile metaphor to vector graphics: in addition to standard image tiles, Polymaps supports vector tiles that are rendered with SVG. The vector geometry is loaded as GeoJSON via asynchronous XMLHttpRequest; Point geometry objects are rendered as SVG circle elements, Polygons as paths, and so on. By loading geometry at known tile boundaries, requests can be issued efficiently on-demand by the client, and responses trivially cached on the server. When the user zooms in, geometry can be seamlessly refined to show greater detail, while on zoom out, geometry can be simplified to improve performance.


You will need the Polymaps JavaScript library for the example and it can be downloaded from the main site http://polymaps.org/

Full documentation for this library is at the Polymaps.org main site.

You can use a code editor of your choise, but this example is build with Aptana Studio and the WRT S60 plugin.

A phone device supporting with Web Runtime support installed.

Example code

For this example we will create a default WRT S60 widget, with the following files

index.html basic.css basic.js


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
<html xmlns="http://www.w3.org/1999/xhtml">
<title> Sample web app</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<script language="javascript" type="text/javascript" src="basic.js"></script>
<script language="javascript" type="text/javascript" src="simplegeo-polymaps-4f09be6/polymaps.js"></script>
<link rel="stylesheet" href="basic.css" type="text/css" />
<meta name="Generator" content="Nokia WDE 3.0.0" />
<body onload="init();">
<div id="map"></div>


//The stylesheet is not implemented for this example.


function init()
var po = org.polymaps;
var map = po.map()
+ "/1a1b06b230af4efdbb989ea99e9841af" // http://cloudmade.com/register
+ "/999/256/{Z}/{X}/{Y}.png")
.hosts(["a.", "b.", "c.", ""])));
107 page views in the last 30 days.