r.in.wms(1grass) | GRASS GIS User's Manual | r.in.wms(1grass) |
r.in.wms - Downloads and imports data from OGC WMS and OGC WMTS web mapping servers.
raster, import, OGC web services, OGC WMS, OGC WMTS
r.in.wms
r.in.wms --help
r.in.wms [-cob] url=string
output=name layers=string[,string,...]
[styles=string[,string,...]]
[format=string] [srs=integer]
[driver=string] [wms_version=string]
[maxcols=integer] [maxrows=integer]
[urlparams=string] [username=string]
[password=string] [method=string]
[gdal_createopt=string[,string,...]]
[region=string] [bgcolor=string]
[proxy=string] [proxy_user_pw=string]
[capfile=name] [capfile_output=name]
[--overwrite] [--help] [--verbose] [--quiet]
[--ui]
r.in.wms handles all of downloading and importing raster data from OGC WMS and OGC WMTS web mapping servers. It only needs 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.
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 (see examples)
If possible, the EPSG code of the current location should be used with the srs option to avoid unnecessary reprojection.
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.
Into the parameter layers the name of the TiledGroup need to be inserted from Tile Service file. Time variable can be specified in urlparams parameter, e.g: urlparams=’time=2012-1-1’.
# Topographic WMS with OpenStreetMap by mundialis r.in.wms -c url="http://ows.mundialis.de/services/service?" r.in.wms -c url="http://ows.mundialis.de/services/service?" | grep Name # Czech WMS r.in.wms -c url="http://wms.cuzk.cz/wms.asp"
# OSM, using WMS_GRASS driver g.region n=90 s=-90 w=-180 e=180 res=0:10:00 -p r.in.wms url="http://watzmann-geog.urz.uni-heidelberg.de/cached/osm" layers=osm_auto:all output=osm format=png r.info osm
# OSM Overlay WMS (can be used as an overlay for other maps) r.in.wms url="http://ows.mundialis.de/services/service?" layer=OSM-Overlay-WMS output=osm_overlay format=png # TOPO-OSM-WMS r.in.wms url="http://ows.mundialis.de/services/service?" layer=TOPO-OSM-WMS output=topo_osm format=png r.info topo_osm # TOPO-WMS r.in.wms url="http://ows.mundialis.de/services/service?" layer=TOPO-WMS output=topo format=png r.info topo
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.
# using WMS_GRASS driver r.in.wms url="http://www2.demis.nl/WMS/wms.asp" layers=Countries,Borders,Coastline output=countries srs=4326 format=png r.info countries
# North Carolina sample data g.region raster=elevation -p # using WMS_GRASS driver r.in.wms url="https://tiles.maps.eox.at/wms?" layers=s2cloudless output=sentinel2 format=png r.info sentinel2
Figure: Raleigh (NC, USA) seen by Sentinel-2 (10m resolution; image courtesy: EOX)
# using WMTS_GRASS driver 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="*" r.info orthophoto
Note: username, password and API key can be obtained from IGN API website
# using WMS_GRASS driver r.in.wms url="http://wms.cuzk.cz/wms.asp" layers=prehledka_kraju-linie srs=4326 output=kn format=png
# using WMTS_GRASS driver r.in.wms url="http://geoportal.cuzk.cz/WMTS_ORTOFOTO/WMTService.aspx" layers=orto output=orthophoto \
srs=3857 format=jpeg driver=WMTS_GRASS style=default r.info orthophoto
Note: data are provided by Czech office for surveying, mapping and cadastre.
Copernicus Core003 View Services - Optical VHR2 coverage over EU
2011-2013 (provided by JRC; usage is restricted to non-commercial
activities):
# get WMS layer list r.in.wms -c url="http://cidportal.jrc.ec.europa.eu/copernicus/services/ows/wms/public/core003?" r.in.wms -c url="http://cidportal.jrc.ec.europa.eu/copernicus/services/ows/wms/public/core003?" | grep Name # spatial subset of Europe # enlarging maxcols and maxrows in order to minimize impact of copyright notice in map g.region n=56 s=47 w=5 e=16 res=0:00:10 -pa # using WMS_GRASS driver r.in.wms url="http://cidportal.jrc.ec.europa.eu/copernicus/services/ows/wms/public/core003?" \
layer="OI.Mosaic.NaturalColor.Feathering" output="jrc_copernicus_core003_mosaik" \
maxcols=3400 maxrows=3400 r.info jrc_copernicus_core003_mosaik # Alternatively, using WMS_GDAL driver with BIGTIFF and compression enabled r.in.wms url="http://cidportal.jrc.ec.europa.eu/copernicus/services/ows/wms/public/core003?" \
layer="OI.Mosaic.NaturalColor.Feathering" output="jrc_copernicus_core003_mosaik2" \
maxcols=3400 maxrows=3400 driver=WMS_GDAL gdal_createopt="BIGTIFF=YES,COMPRESS=DEFLATE" r.info jrc_copernicus_core003_mosaik2
r.in.wms requires the gdalwarp utility from the GDAL/OGR library.
r.in.gdal, r.patch, r.colors, r.composite, v.in.wfs
See also WMS support in wxGUI.
Stepan Turek, Czech Technical University in Prague, Czech Republic
(bachelor’s final project 2012, mentor: Martin Landa)
Available at: r.in.wms source code (history)
Accessed: Sunday Jan 22 07:37:43 2023
Main index | Raster index | Topics index | Keywords index | Graphical index | Full index
© 2003-2023 GRASS Development Team, GRASS GIS 8.2.1 Reference Manual
GRASS 8.2.1 |