OpenLayers 3
JavaScript CSS HTML Python GLSL Makefile Shell
Clone or download
Pull request Compare This branch is 590 commits ahead, 2211 commits behind openlayers:master.
Latest commit a38c510 Oct 26, 2017
Failed to load latest commit information.
.github Nicer wording in the issue template Sep 13, 2017
bin Update to v4.4.2 Oct 26, 2017
changelog Bumping versions and logging changes for v4.4.2 Oct 13, 2017
config Update to v4.4.2 Oct 26, 2017
css update ol3 Sep 14, 2017
doc Parse PBF directly in ol.format.MVT Aug 29, 2017
examples LV03 to LV95 Oct 26, 2017
externs Update to v4.4.2 Oct 26, 2017
package Bumping versions and logging changes for v4.4.2 Oct 13, 2017
resources Fix examples Sep 29, 2016
src Add sr parameter in identify request Oct 26, 2017
tasks Rename before running transform Sep 12, 2017
test Pre-render text images for configured scale Oct 13, 2017
transforms Use lowercase module identifiers until ol@5 Oct 6, 2017
.editorconfig Simplify .editorconfig file Aug 19, 2015
.eslintignore Try to fix lint in the package May 3, 2017
.gitignore Ignore coverage output directory Aug 19, 2017
.npmignore Remove '*.pyc' from .{git,npm}ignore Dec 2, 2015
.travis.yml Let Travis use the latest node v8 version again Sep 14, 2017 Use the 'openlayers' tag instead of 'openlayers-3' Feb 7, 2017 Tell people to use Node 8 Aug 17, 2017 Use present in license text Jan 17, 2017 Update Jan 16, 2014
Makefile Replace with a JavaScript rewrite Aug 29, 2017
Makefile-ga Fix compilation ol3 Sep 25, 2017 Fix README, ol.css is inlcuded in ga.css Oct 26, 2017 Fix host-examples target Nov 6, 2014
package.json Bumping versions and logging changes for v4.4.2 Oct 13, 2017 simpliest webserver with proxy using only standard modules Apr 28, 2014

Geoadmin API

To compile use:

$ make -f Makefile-ga build-ga

To run examples use:

$ make -f Makefile-ga serve

Examples available at : http://localhost:3000/build/examples/

To run hosted examples use:

$ make -f Makefile-ga hosted-examples-ga

Hosted example with compiled version : http://localhost:3000/build/hosted/master/examples/ga-custom.html

Hosted example with non-compiled version : http://localhost:3000/build/hosted/master/examples/ga-custom.html?mode=raw

List of version available:

$ aws --profile [s3_profile] s3 ls s3://[bucket_name]/resources/api/

Publish a new version:

$ aws --profile [s3_profile] s3 cp build s3://[bucket_name]/resources/api/4.3.2 --recursive --exclude "*" --include "ga.js" --include "ga-debug.js" --include "ga.css"
$ aws --profile [s3_profile] s3 cp s3://[bucket_name]/resources/api/3.18.2/EPSG21781.js s3://[bucket_name]/resources/api/4.3.2/
$ aws --profile [s3_profile] s3 cp s3://[bucket_name]/resources/api/3.18.2/EPSG2056.js  s3://[bucket_name]/resources/api/4.3.2/

Delete a version:

$ aws --profile [s3_profile] s3 rm s3://[bucket_name]/resources/api/4.3.2 --recursive

OpenLayers 3

Travis CI Status Greenkeeper badge Coverage Status OSGeo Project

OpenLayers is a high-performance, feature-packed library for creating interactive maps on the web. It can display map tiles, vector data and markers loaded from any source on any web page. OpenLayers has been developed to further the use of geographic information of all kinds. It is completely free, Open Source JavaScript, released under the 2-clause BSD License (also known as the FreeBSD).

Getting Started

Use one of the following methods to use OpenLayers in your project:

  • For use with webpack, Rollup, Browserify, or other module bundlers, install the ol package:

    npm install ol
  • If you just want to add a <script> tag to test things out, you can link directly to one of the full builds from cdnjs (not recommended for production)

  • For use with Closure Library (rare), install the openlayers package and read the tutorial.

Supported Browsers

OpenLayers runs on all modern browsers that support HTML5 and ECMAScript 5. This includes Chrome, Firefox, Safari and Edge. For older browsers and platforms like Internet Explorer (down to version 9) and Android 4.x, polyfills for requestAnimationFrame and Element.prototype.classList are required, and using the KML format requires a polyfill for URL.


Check out the hosted examples, the workshop or the API documentation.


Please use the GitHub issue tracker for all bugs and feature requests. Before creating a new issue, do a quick search to see if the problem has been reported already.


Please see our guide on contributing if you're interested in getting involved.