DESCRIPTION
r.in.wms handles all of downloading and importing raster data
from an OGC
WMS, OGC
WMTS and NASA
OnEarth Tiled WMS web mapping servers. It needs only be told the
desired data to collect (bounds and resolution) via a region, the
server to get the data from, and the layer or layers to get. It
downloads the data in tiles, reprojects it, imports it, and patches it
back together.
NOTES
To understand the data you are getting it is necessary to look at the
capabilities of the WMS server. This should be available via a
capabilities request, an
example
capabilities request to NASA's OnEarth server.
When using GDAL WMS driver (driver=WMS_GDAL), the GDAL library
needs to be built with WMS support,
see GDAL WMS manual page
for details.
NASA OnEarth Tiled WMS
Into parameter layers insert name of TiledGroup from
Tile Service file. Time variable is possible to specify
in urlparams parameter,
e.g: urlparams='time=2012-1-1'.
EXAMPLES
General Get Capabilities Request
r.in.wms -c url=http://wms.cuzk.cz/wms.asp
Download raster data from WMS server (GetMap request)
Open Street Map
Note: European coverage:
r.in.wms url=http://watzmann-geog.urz.uni-heidelberg.de/cached/osm layers=osm_auto:all output=osm format=png
r.in.wms url=http://irs.gis-lab.info layers=osm output=osm format=png
More OSM WMS servers can be found online, e.g. on the OSM wiki in a
OSM WMS Servers list
and on the OSM-WMS-EUROPE page.
World data
r.in.wms url=http://iceds.ge.ucl.ac.uk/cgi-bin/icedswms layers=bluemarble,landsat_1_01 styles=default,default output=landsat srs=4326 format=png
Note: server supports only WMS 1.1.1
r.in.wms url=http://www2.demis.nl/WMS/wms.asp layers=Countries,Borders,Coastline output=countries srs=4326 format=png
OGC WMTS Example
r.in.wms url=http://gpp3-wxs.ign.fr/yourAPIkey/geoportail/wmts layers=ORTHOIMAGERY.ORTHOPHOTOS output=orthophoto srs=3857 format=jpeg driver=WMTS_GRASS style=normal password=* username=*
Note: username, password and API key can be get from IGN API website
NASA OnEarth Tiled WMS Example
r.in.wms output=global_mosaic url=http://onearth.jpl.nasa.gov/wms.cgi layers='Global Mosaic, visual' driver=OnEarth_GRASS
Data covering the Czech Republic
r.in.wms output=kn url=http://wms.cuzk.cz/wms.asp layers=prehledka_kraju-linie srs=4326 format=png
r.in.wms url=http://geoportal.cuzk.cz/WMTS_ORTOFOTO/WMTService.aspx layers=orto output=ortofoto srs=3857 format=jpeg driver=WMTS_GRASS style=default
Note: data are provided by Czech office for surveying, mapping and cadastre.
REQUIREMENTS
r.in.wms
requires gdalwarp
utility from GDAL/OGR library.
REFERENCES
SEE ALSO
r.in.gdal,
r.patch,
r.colors,
r.composite,
v.in.wfs
See
also WMS
support in wxGUI.
AUTHOR
Stepan Turek, Czech Technical University in Prague, Czech Republic
(bachelor's final project 2012, mentor: Martin Landa)
Last changed: $Date$