OWSLib is a Python package for client programming with Open Geospatial Consortium (OGC) web service (hence OWS) interface standards, and their related content models.
Full documentation is available at https://owslib.readthedocs.io
OWSLib provides a common API for accessing service metadata and wrappers for numerous OGC Web Service interfaces.
The easiest way to install OWSLib is via the Python pip utility:
pip3 install OWSLib- Python 3
- virtualenv
Dependencies are listed in pyproject.toml. Dependencies are automatically installed during OWSLib installation.
# setup virtualenv
python3 -m venv owslib
cd owslib
source bin/activate
# clone codebase and install
git clone https://github.com/geopython/OWSLib.git
cd OWSLib
pip3 install .Find out what a WMS has to offer. Service metadata:
>>>fromowslib.wmsimportWebMapService>>>wms=WebMapService('http://wms.jpl.nasa.gov/wms.cgi', version='1.1.1')
>>>wms.identification.type'OGC:WMS'>>>wms.identification.version'1.1.1'>>>wms.identification.title'JPL Global Imagery Service'>>>wms.identification.abstract'WMS Server maintained by JPL, worldwide satellite imagery.'Availablelayers::
>>>list(wms.contents)
['us_landsat_wgs84', 'modis', 'global_mosaic_base', 'huemapped_srtm',
'srtm_mag', 'daily_terra', 'us_ned', 'us_elevation', 'global_mosaic',
'daily_terra_ndvi', 'daily_aqua_ndvi', 'daily_aqua_721', 'daily_planet',
'BMNG', 'srtmplus', 'us_colordem', None, 'daily_aqua', 'worldwind_dem',
'daily_terra_721']
Detailsofalayer::
>>>wms['global_mosaic'].title'WMS Global Mosaic, pan sharpened'>>>wms['global_mosaic'].boundingBoxWGS84
(-180.0, -60.0, 180.0, 84.0)
>>>wms['global_mosaic'].crsOptions
['EPSG:4326', 'AUTO:42003']
>>>wms['global_mosaic'].styles
{'pseudo_bright': {'title': 'Pseudo-colorimage (UsesIRandVisualbands,
542mapping), gamma1.5'}, 'pseudo': {'title': '(default) Pseudo-colorimage, pansharpened (UsesIRandVisualbands, 542mapping), gamma1.5'},
'visual': {'title': 'Real-colorimage, pansharpened (Usesthevisualbands, 321mapping), gamma1.5'}, 'pseudo_low': {'title': 'Pseudo-colorimage, pansharpened (UsesIRandVisualbands, 542mapping)'},
'visual_low': {'title': 'Real-colorimage, pansharpened (Usesthevisualbands, 321mapping)'}, 'visual_bright': {'title': 'Real-colorimage (Usesthevisualbands, 321mapping), gamma1.5'}}
Availablemethods, theirURLs, andavailableformats::
>>> [op.nameforopinwms.operations]
['GetTileService', 'GetCapabilities', 'GetMap']
>>>wms.getOperationByName('GetMap').methods
{'Get': {'url': 'http://wms.jpl.nasa.gov/wms.cgi?'}}
>>>wms.getOperationByName('GetMap').formatOptions
['image/jpeg', 'image/png', 'image/geotiff', 'image/tiff']
That'severythingneededtomakearequestforimagery::
>>>img=wms.getmap( layers=['global_mosaic'],
... styles=['visual_bright'],
... srs='EPSG:4326',
... bbox=(-112, 36, -106, 41),
... size=(300, 250),
... format='image/jpeg',
... transparent=True
... )
>>>out=open('jpl_mosaic_visb.jpg', 'wb')
>>>out.write(img.read())
>>>out.close()A very similar API exists for WebFeatureService. See tests/wfs_MapServerWFSCapabilities.txt for details.
There is also support for Web Coverage Service (WCS), Catalogue Service for the Web (CSW), Web Processing Service (WPS), and Web Map Tile Service (WMTS). Some of those are beta quality.
OWSLib logs messages to module-based named Python loggers. You may configure your application to use the log messages like so:
>>>importlogging>>>LOGGER=logging.getLogger(__name__)
>>># Add formatting and handlers as needed, for example to log to the console>>>ch=logging.StreamHandler()
>>>ch.setLevel(logging.DEBUG)
>>>ch.setFormatter(logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s'))
>>># add the handler to the logger>>>LOGGER.addHandler(ch)
>>>LOGGER.setLevel(logging.DEBUG)Requires Python 3.11+ and PanDoc.
sudo apt-get -y install pandoc
pip3 install -e ".[docs]"cd docs && make html
python -m http.server --directory=../build/docs# update version
vi pyproject.toml # update [project]/version
git commit -m 'update release version' owslib/pyproject.toml
# push changes
git push origin master
git tag -a x.y.z -m 'tagging OWSLib release x.y.z'# push tag
git push --tags
# update on PyPI (must be a maintainer)
rm -fr build dist *.egg-info
python3 -m build
twine upload dist/*