Implements RasterSource classes which can retrieve imagery from web services such as WMS and WMTS.
The matplotlib interface can make use of RasterSources via the cartopy.mpl.geoaxes.GeoAxes.add_raster() method, with additional specific methods which make use of this for WMS and WMTS (add_wms() and add_wmts()). An example of using WMTS in this way can be found at wmts example.
Web Feature Service (WFS) retrieval for Cartopy.
Args:
The URL of a WFS, or an instance of owslib.wfs.WebFeatureService.
The typename(s) of the features from the WFS that will be retrieved and made available as geometries.
Kwargs:
Extra keyword args to pass to the service’s getfeature call.
Return a cartopy.crs.Projection in which the WFS service can supply the requested features.
Return any Point, Linestring or LinearRing geometries available from the WFS that lie within the specified extent.
Args:
The projection in which the extent is specified and in which the geometries should be returned. Only the default (native) projection is supported.
(min_x, max_x, min_y, max_y) tuple defining the geographic extent of the geometries to obtain.
A WMS imagery retriever which can be added to a map.
Note
Requires owslib and Pillow to work.
Note
No caching of retrieved maps is done with this WMSRasterSource.
To reduce load on the WMS server it is encouraged to tile map requests and subsequently stitch them together to recreate a single raster, thus allowing for a more aggressive caching scheme, but this WMSRasterSource does not currently implement WMS tile fetching.
Whilst not the same service, there is also a WMTSRasterSource which makes use of tiles and comes with built-in caching for fast repeated map retrievals.
Extra kwargs passed through to the service’s getmap request.
The names of the layers to fetch.
The OWSLib WebMapService instance.
A WMTS imagery retriever which can be added to a map.
Uses tile caching for fast repeated map retrievals.
Note
Requires owslib and Pillow to work.
Args:
owslib.wmts.WebMapTileService instance.
layer_name - The name of the layer to use.
The layer to fetch.
The OWSLib WebMapTileService instance.