Skip to content

A general-purpose OpenStreetMap mapnik style, in CartoCSS

License

Notifications You must be signed in to change notification settings

btwhite92/openstreetmap-carto

This branch is 765 commits behind gravitystorm/openstreetmap-carto:master.

Folders and files

NameName
Last commit message
Last commit date
Mar 29, 2018
Apr 22, 2019
Mar 6, 2019
Aug 1, 2017
May 19, 2018
Jul 8, 2017
Nov 27, 2018
Mar 30, 2019
Jan 15, 2019
May 2, 2019
May 22, 2018
May 3, 2019
Jan 15, 2019
Jan 15, 2019
Aug 9, 2018
Aug 9, 2018
Apr 22, 2019
Jan 19, 2017
Jan 15, 2019
Jan 15, 2019
May 16, 2018
Jan 20, 2018
Feb 7, 2019
Apr 16, 2018
May 21, 2019
Feb 6, 2019
May 11, 2018
Nov 20, 2017
Mar 30, 2019
Feb 19, 2019
Feb 19, 2019
Apr 15, 2019
Apr 27, 2018
Jan 19, 2017
May 21, 2019
May 21, 2019
Feb 15, 2019
Jun 11, 2019
Jul 11, 2016
Jul 11, 2016
Jun 10, 2019
Mar 25, 2019
Feb 22, 2019
Mar 25, 2019
Mar 10, 2019
May 17, 2019

Repository files navigation

OpenStreetMap Carto

screenshot

These are the CartoCSS map stylesheets for the Standard map layer on OpenStreetMap.org.

These stylesheets can be used in your own cartography projects, and are designed to be easily customised. They work with Kosmtik and also with the command-line CartoCSS processor.

Since August 2013 these stylesheets have been used on the OSMF tileservers (tile.openstreetmap.org), and are updated from each point release. They supersede the previous XML-based stylesheets.

Installation

You need a PostGIS database populated with OpenStreetMap data along with auxillary shapefiles. See INSTALL.md.

Contributing

Contributions to this project are welcome, see CONTRIBUTING.md for full details.

Versioning

This project follows a MAJOR.MINOR.PATCH versioning system. In the context of a cartographic project you can expect the following:

  • PATCH: When a patch version is released, there would be no reason not to upgrade. PATCH versions contain only bugfixes e.g. stylesheets won't compile, features are missing by mistake, etc.
  • MINOR: These are routine releases and happen every 2-5 weeks. They will contain changes to what's shown on the map, how they appear, new features added and old features removed. They may rarely contain changes to assets i.e. shapefiles and fonts but will not contain changes that require software or database upgrades.
  • MAJOR: Any change the requires reloading a database, or upgrading software dependecies will trigger a major version change.

Roadmap

Initial Release (v1.0.0, December 2012)

This was a full re-implementation of the original OSM style, with only a few bugs discovered later. There's been no interest in creating further point releases in the v1.x series.

Mapnik 2 work (v2.x)

The v2.x series initially focused on refactoring the style, both to to fix glitches and to leverage new features in CartoCSS / Mapnik to simplify the stylesheets with only small changes to the output, as well as removing 'old-skool' tagging methods that are now rarely used. It then started adding new features.

Mapnik and CartoCSS update (v3.x)

The v3.x series was triggered by an update to the required Mapnik and CartoCSS versions.

Care has been taken to not get too clever with variables and expressions. While these often make it easier to customise, experience has shown that over-cleverness (e.g. interpolated entities) can discourage contributions.

Database schema change (v4.x)

The v4.x series includes osm2pgsql lua transforms and a hstore column with all other tags, allowing use of more OpenStreetMap data. Users need to reload their databases, v3.x compatibility is not maintained.

There are over 300 open requests, some that have been open for years. These need reviewing and dividing into obvious fixes, or additional new features that need some cartographic judgement.

Alternatives

There are many open-source stylesheets written for creating OpenStreetMap-based maps using Mapnik, many based on this project. Some alternatives are:

Maintainers

About

A general-purpose OpenStreetMap mapnik style, in CartoCSS

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • CartoCSS 84.9%
  • Python 8.3%
  • Lua 5.4%
  • Other 1.4%