GRASS logo

Note: A new GRASS GIS stable version has been released: GRASS GIS 7. Go directly to the new manual page here

NAME - Downloads and imports data from WMS servers.



SYNOPSIS help [-ldockpg] [output=string] mapserver=string [layers=string[,string,...]] [styles=string[,string,...]] [srs=string] format=string [wmsquery=string] maxcols=integer maxrows=integer [tileoptions=string] [region=string] [folder=string] [wgetoptions=string] [curloptions=string] method=string [cap_file=string] [v=integer] [--overwrite] [--verbose] [--quiet]


List available layers and exit
Skip to downloading (to resume downloads faster)
Don't request transparent data
Clean existing data out of download directory
Keep band numbers instead of using band color names
Don't reproject the data, just patch it
Use GET method instead of POST data method
This may be needed to connect to servers which lack POST capability
Allow output files to overwrite existing files
Verbose module output
Quiet module output


Name for output raster map
Mapserver to request data from
Layers to request from map server
Styles to request from map server
Source projection to request from server
Default: EPSG:4326
Image format requested from the server
Options: geotiff,tiff,jpeg,gif,png
Default: geotiff
Addition query options for server
Default: version=1.1.1
Maximum columns to request at a time
Default: 1024
Maximum rows to request at a time
Default: 1024
Additional options for r.tileset
Named region to request data for. Current region used if omitted
Folder to save downloaded data to
Additional options for wget
Default: -c -t 5 -nv
Additional options for curl
Default: -C - --retry 5 -s -S
Reprojection method to use
Options: nearest,bilinear,cubic,cubicspline
Default: nearest
Filename to save capabilities XML file to
Requires list available layers flag
Verbosity level
Default: 1

DESCRIPTION handles all of downloading and importing raster data from an OGC WMS web mapping server. It need 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.


By default data is downloaded to $GISDBASE/wms_download. This can be changed by setting the folder option when using

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. This is an example capabilities request to NASA's OnEarth server.

Other brain-dead servers will not accept queries in the form of POST data. If you get an error try using the -g flag to force to send an atomic GET request instead.


General Get Capabilities Request

A capabilities request like is where you should start. It tells you what data is offered, the projections it is in, where to find meta data, resolutions, scales, and bounds for data, etc. For example lists the layers available from TelaScience's OSGeo/FlightGear landcover server. mapserver="" -l

Land Cover

In a Lat/Lon location first set the region to cover the state of North Carolina and the resolution to 30 arc-seconds.
g.region -p n=37N s=33N w=85W e=75W res=0:00:30 output=nc_landcover mapserver="" \
         layer=LANDCOVER format=png
North Carolina landcover map
North Carolina landcover map

DRG from Terraserver server download

Set the resolution to 1.2 meters for DRGs. Their native resolution is 2.4 meters, so this is some pretty hefty oversampling:
g.region res=1.2 -ap
g.region save=drg-resolution output=terraserver-drg mapserver="" \
         layers=DRG region=drg-resolution format=jpeg srs=EPSG:26910
Downloads digital raster graphics from Microsoft TerraServer. Note that srs will need to be changed to a projection that is appropriate for your region.

REQUIRED PROGRAMS requires the following programs to work:


r.tileset,, r.patch, r.colors, r.composite


Soeren Gebbert, Jachym Cepicky, and Cedric Shock

Last changed: $Date: 2013-07-18 11:23:35 -0700 (Thu, 18 Jul 2013) $

Main index - raster index - Full index

© 2003-2016 GRASS Development Team