Flags:

-c

Get the server capabilities then exit

-o

Do not request transparent data

--overwrite

Allow output files to overwrite existing files

--help

Print usage summary

--verbose

Verbose module output

--quiet

Quiet module output

--ui

Force launching GUI dialog

Parameters:

url=string [required]

Typically starts with "http://"

output=name [required]

Name for output raster map

layers=string[,string,...] [required]

Layer(s) to request from the map server

styles=string[,string,...]

Layer style(s) to request from the map server

format=string

Image format requested from the server
Options: geotiff, tiff, jpeg, gif, png, png8
Default: png

srs=integer

EPSG code of requested source projection
Default: 4326

driver=string

Driver used to communication with server
Options: WMS_GDAL, WMS_GRASS, WMTS_GRASS, OnEarth_GRASS
Default: WMS_GRASS
WMS_GDAL: Download data using GDAL WMS driver
WMS_GRASS: Download data using native GRASS-WMS driver
WMTS_GRASS: Download data using native GRASS-WMTS driver
OnEarth_GRASS: Download data using native GRASS-OnEarth driver

wms_version=string

WMS standard version
Options: 1.1.1, 1.3.0
Default: 1.1.1

maxcols=integer

Maximum columns to request at a time
Default: 512

maxrows=integer

Maximum rows to request at a time
Default: 512

urlparams=string

Additional query parameters to pass to the server

username=string

Username for server connection

password=string

Password for server connection

method=string

Interpolation method to use in reprojection
Options: nearest, linear, cubic, cubicspline
Default: nearest

region=string

Request data for this named region instead of the current region bounds

bgcolor=string

Background color
Format: 0xRRGGBB

capfile=name

Capabilities file to parse (input). It is relevant for WMTS_GRASS and OnEarth_GRASS drivers

capfile_output=name

File where the server capabilities will be saved (’c’ flag)

Tiled WMS

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’.

General Get Capabilities Request

# 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"

Download raster data from WMS server (GetMap request)

Open Street Map

# OSM
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

# 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
# TOPO-WMS
r.in.wms url="http://ows.mundialis.de/services/service?" layer=TOPO-WMS output=topo 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.

Countries and coastlines

r.in.wms url="http://www2.demis.nl/WMS/wms.asp" layers=Countries,Borders,Coastline output=countries srs=4326 format=png

Sentinel-2 satellite cloud free global coverage

# North Carolina sample data
g.region raster=elevation -p
r.in.wms url="https://tiles.maps.eox.at/wms?" layers=s2cloudless output=sentinel2 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 obtained from IGN API website

Data covering the Czech Republic

r.in.wms url="http://wms.cuzk.cz/wms.asp" layers=prehledka_kraju-linie srs=4326 output=kn 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.