|Number of watchers on Github||588|
|Number of open issues||44|
|Average time to close an issue||7 months|
|Average time to merge a PR||19 days|
|Open pull requests||11+|
|Closed pull requests||6+|
|Last commit||about 4 years ago|
|Repo Created||almost 10 years ago|
|Repo Last Updated||over 2 years ago|
|Organization / Author||mapbox|
|Do you use osm-bright? Leave a review!|
|View open issues (44)|
|View osm-bright activity|
|View on github|
|Book a Mock Interview With Me (Silicon Valley Engineering Leader, 100s of interviews conducted)|
Software engineers: It's time to get promoted. Starting NOW! Subscribe to my mailing list and I will equip you with tools, tips and actionable advice to grow in your career.
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.
OSM Bright depends on two large shapefiles. You will need to download and extract them before continuing.
Download them to the
shp directory in the osm-bright folder. You can do this with
wget http://data.openstreetmapdata.com/simplified-land-polygons-complete-3857.zip wget http://data.openstreetmapdata.com/land-polygons-split-3857.zip
If you are going to use the osm2pqsql style you will need another (but smaller shapefile) wget http://mapbox-geodata.s3.amazonaws.com/natural-earth-1.4.0/cultural/10m-populated-places-simple.zip
Once downloaded, extract them from their zip files.
Shapeindex is a tool that improves performance for shapefiles in Tilemill.
Mac and Linux users already have Shapeindex installed through Tilemill but Windows users will need to download Shapeindex for Windows before continuing.
To run Shapeindex on Mac and Linux, go to the terminal, move to the shp directory of osm-bright, run shapeindex in each shp subdirectory like:
You will need an OSM database extract in one of the following formats:
You can find appropriate data extracts for a variety of regions at http://download.geofabrik.de or https://mapzen.com/metro-extracts/. See the OSM wiki for information about (very large) full-planet downloads.
If you are using Imposm, you should use the included mapping configuration which includes a few important tags compared to the default. The Imposm import command looks like this:
imposm -U <postgres_user> -d <postgis_database> \ -m /path/to/osm-bright/imposm-mapping.py --read --write \ --optimize --deploy-production-tables <data.osm.pbf>
imposm --help or the online documentation for more details.
If you are using osm2pgsql the default style file should work well. The osm2pgsql import command looks like this:
osm2pgsql -c -G -U <postgres_user> -d <postgis_database> <data.osm.pbf>
man osm2pgsql or the online documentation for more details.
You'll need to adjust some settings for things like your PostgreSQL connection information.
Make a copy of
configure.py.sample and name it
cp configure.py.sample configure.py
configure.py in a text editor.
Make sure the
importer option matches the program you used to import your
Optionally change the name of your project from the default, 'OSM Bright'.
Adjust, if needed, the path to point to your MapBox project folder.
Make any adjustments to the PostgreSQL connection settings. Your database may be set up so that you require a password or different user name.
Optionally adjust the query extents or shapefile locations. (Refer to the comments in the configuration file for more information.)
Save & close the file.
This will create a new folder called
build with your new project, customized
with the variables you set in
configure.py and install a copy of this build
to your MapBox project folder. If you open up TileMill you should see your new
map in the project listing.
Click on the map to view it in the editing interface.
Have patience: the first time the project opens it needs to download very large shapefiles before the map can render. This can take 5-10 minutes on a fast connection and longer on a slow connection. Keep TileMill open and feel free to navigate back to the projects view then back to the project editor view to check on its loading status. You can also check the TileMill logs to see the download status of the remote files.
Once the map tiles show up, you're now ready to start editing the template in TileMill!