New in version 0.9.1.
With coverages you can define areas where data is available or where data you are interested in is. MapProxy supports coverages for sources and in the mapproxy-seed tool. Refer to the corresponding section in the documentation.
There are three different ways to describe a coverage.
- a simple rectangular bounding box,
- a text file with one or more polygons in WKT format,
- polygons from any data source readable with OGR (e.g. Shapefile, PostGIS)
If you want to use polygons to define a coverage, instead of simple bounding boxes, you will also need Shapely and GEOS. For loading polygons from shapefiles you’ll also need GDAL/OGR.
MapProxy requires Shapely 1.2.0 or later and GEOS 3.1.0 or later.
sudo aptitude install libgeos-dev libgdal-dev pip install Shapely
- A simple BBOX as a list, e.g: [4, -30, 10, -28].
- The SRS of the BBOX.
- The name of the datasource. Refer to the OGR format page for a list of all supported datasources. File paths should be relative to the proxy configuration or absolute.
- Restrict which polygons should be loaded from the datasource. Either a simple where statement (e.g. 'CNTRY_NAME="Germany"') or a full select statement. Refer to the OGR SQL support documentation. If this option is unset, the first layer from the datasource will be used.
- The SRS of the polygons.
Use the coverage option to define a coverage for a WMS or tile source.
sources: mywms: type: wms req: url: http://example.com/service? layers: base coverage: bbox: [5, 50, 10, 55] bbox_srs: 'EPSG:4326'
To define a seed-area in the seed.yaml, add the coverage directly to the views.
views: germany: ogr_datasource: 'shps/world_boundaries_m.shp' ogr_where: 'CNTRY_NAME = "Germany"' ogr_srs: 'EPSG:900913' level: [0, 14] srs: ['EPSG:900913', 'EPSG:4326']