Leaflet library for polar map projection switching
npm install polarmapA JavaScript library that can re-project Leaflet maps and map features.
PolarMap.js is part of the Arctic Connect project, specifically the Arctic Web Map module. We thank CANARIE for the funding support.
There are two layers to PolarMap.js: the lower-level Leaflet.PolarMap plugin, and the basic PolarMap library. Each has their advantages depending on the situation. The basic PolarMap library has the default loadout of plugins and configuration for Arctic Connect tiles and services. The Leaflet.PolarMap plugin lets the developer pick and choose their integrations, at the trade-off of more code/configuration.
The Leaflet.PolarMap plugin and PolarMap library both require the following JavaScript libraries to be available:
* Leaflet 0.7.3 to 0.7.7
* Proj4js 2+
* Proj4Leaflet 0.7.2
Support for other versions of these libraries are not currently known, use at your own risk of bugs or unexpected behaviour.
PolarMap.js has a very similar API to Leaflet, so you should feel right at home. First include the stylesheets:
Then require the JavaScript:
And then initialize a map the way you would a Leaflet map:
And you should be up and running with PolarMap.js. For a more detailed explanation of the API and customization options, please see the API Documentation.
It is recommended to download the latest version of PolarMap.js directly from our site. But you can build your own copy from source if you prefer.
To generate a distribution copy of PolarMap.js, you will need to set up the build environment. This requires Node.js. Once Node is installed, you can use NPM to set up the dependencies:
$ npm install -g jake
$ npm install
And then generate the build products:
$ jake build
Two copies of PolarMap.js will be generated in the dist directory, one with comments and the other compressed with uglifier-js.
See the examples directory for more information on how to use PolarMap.js with various Leaflet plugins and features.
To run a local webserver for testing the app, use the packaged Node http-server:
$ jake server
It will serve the local directory over HTTP on port 8080.
This library has tests for the lower-level plugin that run using Mocha, Sinon, and Expect.js. They can be run in the browser by opening spec/index.html or on the command line with jake test.
Different versions of PolarMap.js are available for different versions of Leaflet.
| Leaflet Version | PolarMap.js Version |
|---|---|
| 0.7.x | 1.1.x |
| 1.0.x | 2.0.x |
A version of PolarMap.js for Leaflet 1.0.x is not yet available.
This library contains modified code from the leaflet-hash project. Leaflet-hash is MIT Licensed.
PolarMap.js is maintained by James Badger (@openfirmware) and the GeoSensorWeb Lab. If you have issues with the JavaScript library portion, please post an issue on the PolarMap.js issue tracker.
If you are having issue with the underlying map data, such as map inaccuracies, missing data, or general style comments, then please post an issue on the Web Map issue tracker.
PolarMap.js is released under the BSD 2-Clause license (same as Leaflet).