https://github.com/MapServer/basemaps
Scripts to generate MapServer mapfiles based on OpenStreetMap data. Please submit pull requests to the 'main' branch.
https://github.com/MapServer/basemaps
c imposm mapserver openstreetmap openstreetmap-data osm osm2pgsql python
Last synced: 5 months ago
JSON representation
Scripts to generate MapServer mapfiles based on OpenStreetMap data. Please submit pull requests to the 'main' branch.
- Host: GitHub
- URL: https://github.com/MapServer/basemaps
- Owner: MapServer
- Created: 2012-03-19T12:46:13.000Z (over 13 years ago)
- Default Branch: main
- Last Pushed: 2025-03-04T14:56:07.000Z (7 months ago)
- Last Synced: 2025-03-04T15:39:10.056Z (7 months ago)
- Topics: c, imposm, mapserver, openstreetmap, openstreetmap-data, osm, osm2pgsql, python
- Language: Python
- Homepage:
- Size: 96.2 MB
- Stars: 63
- Watchers: 12
- Forks: 46
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-starred - MapServer/basemaps - Scripts to generate MapServer mapfiles based on OpenStreetMap data. Please submit pull requests to the 'main' branch. (c)
README
# MapServer OSM basemaps
- This package uses a Python script and the C preprocessor to build a
complete [MapServer](https://mapserver.org) mapfile from a set of templates and styling information,
for [OpenStreetMap](https://www.openstreetmap.org) data.
- Please perform all pull requests into the `main` branch, and
inside the pull request mention which branch to backport the changes to;
one of the repository managers will then apply the corresponding label,
to magically backport to that branch.
- use branch `main` for all pull requests
- other branches to possibly backport to include:
- `mapserver-7.6`
- `branch-6-2`
- The build process uses the gcc preprocessor extensively, you should have it installed on your
system. On linux, check that the `cpp` command is present. On OSX, the provided `cpp` program is a shell
wrapper that is not suitable: the Makefile is coded to call `cpp-4.2`, which you can change in case
you have another version installed.
- The mapfiles rely on the database schema as created by a recent version of imposm. Until recently
imposm did not create the `landusages_gen` and `waterareas_gen` tables. Since 2.3.0 this is not the case anymore.
If you do not have the generalized tables, you can change the `landusage_data` and `waterareas_data` entries in
`generate_style.py` so that it queries the non-generalized
tables on the lower zoom levels (this will be slower for the lower zoom levels).
- The generated mapfile can also be made to query an osm database created with `osm2pgsql` rather than `imposm`.
This setup is not recommended as it will be much slower. To use the osm2pgsql schema, you should add the `osm2pgsql`
entry to the list of styles for an entry of style_aliases near the end of generate_style.py, e.g:
`"bingosm2pgsql":"default,outlined,bing,osm2pgsql"` then run `make STYLE=bingosm2pgsql` to create the `osm-bingosm2pgsql.map`
- Most configuration and tweaks should be done in `generate_style.py`.
Documentation as to how to edit can be found at
https://mapserver.org/basemaps/style.html.
- Windows users can follow the steps at https://github.com/MapServer/MapServer/wiki/RenderingOsmDataWindows
## Docker installation
After installing docker and docker compose, run the following command (port 80
should not be already used in your local system):
```
docker compose up -d
```
Then use your browser to go to:
```
http://localhost?SERVICE=WMS&VERSION=1.3.0&REQUEST=GetCapabilities
```