Skip to content

Latest commit

 

History

History
65 lines (45 loc) · 2.18 KB

README.md

File metadata and controls

65 lines (45 loc) · 2.18 KB

OSM Bright

OSM Bright is a sensible starting point for quickly making beautiful maps based on an OpenStreetMap database. It is written in the Carto styling language and can be opened as a project in TileMill.

The style is still a work in progress and you are encouraged to use the issue tracker to note missing features or problems with the current implementation.

Setup Instructions

1. Set up PostgreSQL & PostGIS

If you don't already, you need to have PostgreSQL installed & running with a PostGIS database setup within it. See the PostGIS documentation for full information on how to do this

2. Import OpenStreetMap data

You will need an OSM database extract in one of the following formats:

  • .osm.pbf (binary; smallest & fastest)
  • .osm.bz2 (compressed xml)
  • .osm (xml)

You can find appropriate data extracts for a variety of regions at http://download.geofabrik.de/osm or http://downloads.cloudmade.com. See also the OSM wiki for information about (very large) full-planet downloads.

OSM Bright requires a PostGIS database imported with ImpOSM. Support for OSM2PGSQL is planned but not yet implemented.

A basic ImpOSM import command looks like:

imposm --read --write --deploy-production-tables -U <user> -d <db> <data.osm.pbf>

See imposm --help or the online documentation for more details.

Note that if you use a custom database prefix or want to see the style on a tables that have not been "deployed to production" (ie. have an osm_new_ prefix) you will have to manually update the SQL queries in the MML file to reflect this.

3. Run configure.py

Included in with this style is a configuration script to help you adjust parameters such as the database connection information and a few other things.

TODO: go on...