1r.in.wms(1)                   Grass User's Manual                  r.in.wms(1)
2
3
4

NAME

6       r.in.wms   -  Downloads  and  imports  data  from WMS/WMTS/NASA OnEarth
7       server.
8

KEYWORDS

10       raster, import, OGC web services
11

SYNOPSIS

13       r.in.wms
14       r.in.wms --help
15       r.in.wms  [-co]   url=string   output=name   layers=string[,string,...]
16       [styles=string[,string,...]]        [format=string]       [srs=integer]
17       [driver=string]         [wms_version=string]          [maxcols=integer]
18       [maxrows=integer]     [urlparams=string]    [username=string]    [pass‐
19       word=string]    [method=string]    [region=string]     [bgcolor=string]
20       [capfile=name]      [capfile_output=name]     [--overwrite]    [--help]
21       [--verbose]  [--quiet]  [--ui]
22
23   Flags:
24       -c
25           Get the server capabilities then exit
26
27       -o
28           Do not request transparent data
29
30       --overwrite
31           Allow output files to overwrite existing files
32
33       --help
34           Print usage summary
35
36       --verbose
37           Verbose module output
38
39       --quiet
40           Quiet module output
41
42       --ui
43           Force launching GUI dialog
44
45   Parameters:
46       url=string [required]
47           Typically starts with "http://"
48
49       output=name [required]
50           Name for output raster map
51
52       layers=string[,string,...] [required]
53           Layer(s) to request from the map server
54
55       styles=string[,string,...]
56           Layer style(s) to request from the map server
57
58       format=string
59           Image format requested from the server
60           Options: geotiff, tiff, jpeg, gif, png, png8
61           Default: png
62
63       srs=integer
64           EPSG code of requested source projection
65           Default: 4326
66
67       driver=string
68           Driver used to communication with server
69           Options: WMS_GDAL,  WMS_GRASS,  WMTS_GRASS,  OnEarth_GRASS
70           Default: WMS_GRASS
71           WMS_GDAL: Download data using GDAL WMS driver
72           WMS_GRASS: Download data using native GRASS-WMS driver
73           WMTS_GRASS: Download data using native GRASS-WMTS driver
74           OnEarth_GRASS: Download data using native GRASS-OnEarth driver
75
76       wms_version=string
77           WMS standard version
78           Options: 1.1.1, 1.3.0
79           Default: 1.1.1
80
81       maxcols=integer
82           Maximum columns to request at a time
83           Default: 512
84
85       maxrows=integer
86           Maximum rows to request at a time
87           Default: 512
88
89       urlparams=string
90           Additional query parameters to pass to the server
91
92       username=string
93           Username for server connection
94
95       password=string
96           Password for server connection
97
98       method=string
99           Interpolation method to use in reprojection
100           Options: nearest, linear, cubic, cubicspline
101           Default: nearest
102
103       region=string
104           Request data for this named region instead of  the  current  region
105           bounds
106
107       bgcolor=string
108           Background color
109           Format: 0xRRGGBB
110
111       capfile=name
112           Capabilities  file  to parse (input). It is relevant for WMTS_GRASS
113           and OnEarth_GRASS drivers
114
115       capfile_output=name
116           File where the server capabilities will be saved (’c’ flag)
117

DESCRIPTION

119       r.in.wms handles all of downloading and importing raster data  from  an
120       OGC  WMS  and  OGC  WMTS web mapping servers. It only needs be told the
121       desired data to collect (bounds  and  resolution)  via  a  region,  the
122       server  to  get the data from, and the layer or layers to get. It down‐
123       loads the data in tiles, reprojects it, imports it, and patches it back
124       together.
125

NOTES

127       To  understand  the data you are getting it is necessary to look at the
128       capabilities of the WMS server. This should be available via a capabil‐
129       ities request (see examples)
130
131       When using GDAL WMS driver (driver=WMS_GDAL), the GDAL library needs to
132       be built with WMS support, see GDAL WMS manual page for details.
133
134   Tiled WMS
135       Into the parameter layers  the  name  of  the  TiledGroup  need  to  be
136       inserted from Tile Service file. Time variable can be specified in url‐
137       params parameter, e.g: urlparams=’time=2012-1-1’.
138

EXAMPLES

140   General Get Capabilities Request
141       # Topographic WMS with OpenStreetMap by mundialis
142       r.in.wms -c url="http://ows.mundialis.de/services/service?"
143       r.in.wms -c url="http://ows.mundialis.de/services/service?" | grep Name
144       # Czech WMS
145       r.in.wms -c url="http://wms.cuzk.cz/wms.asp"
146
147   Download raster data from WMS server (GetMap request)
148   Open Street Map
149       # OSM
150       g.region n=90 s=-90 w=-180 e=180 res=0:10:00 -p
151       r.in.wms url="http://watzmann-geog.urz.uni-heidelberg.de/cached/osm" layers=osm_auto:all output=osm format=png
152       # OSM Overlay WMS (can be used as an overlay for other maps)
153       r.in.wms url="http://ows.mundialis.de/services/service?" layer=OSM-Overlay-WMS output=osm_overlay format=png
154       # TOPO-OSM-WMS
155       r.in.wms url="http://ows.mundialis.de/services/service?" layer=TOPO-OSM-WMS output=topo_osm format=png
156       # TOPO-WMS
157       r.in.wms url="http://ows.mundialis.de/services/service?" layer=TOPO-WMS output=topo format=png
158
159       More OSM WMS servers can be found online, e.g. on the OSM wiki in a OSM
160       WMS Servers list and on the OSM-WMS-EUROPE page.
161
162   Countries and coastlines
163       r.in.wms url="http://www2.demis.nl/WMS/wms.asp" layers=Countries,Borders,Coastline output=countries srs=4326 format=png
164
165   Sentinel-2 satellite cloud free global coverage
166       # North Carolina sample data
167       g.region raster=elevation -p
168       r.in.wms url="https://tiles.maps.eox.at/wms?" layers=s2cloudless output=sentinel2 format=png
169
170   OGC WMTS Example
171       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="*"
172       Note:  username, password and API key can be obtained from IGN API web‐
173       site
174
175   Data covering the Czech Republic
176       r.in.wms url="http://wms.cuzk.cz/wms.asp" layers=prehledka_kraju-linie srs=4326 output=kn format=png
177       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
178       Note: data are provided by Czech  office  for  surveying,  mapping  and
179       cadastre.
180

REQUIREMENTS

182       r.in.wms requires the gdalwarp utility from the GDAL/OGR library.
183

REFERENCES

185           ·   OGC WMS
186
187           ·   OGC WMTS
188

SEE ALSO

190        r.in.gdal, r.patch, r.colors, r.composite, v.in.wfs
191
192       See also WMS support in wxGUI.
193

AUTHOR

195       Stepan  Turek,  Czech  Technical  University  in Prague, Czech Republic
196       (bachelor’s final project 2012, mentor: Martin Landa)
197
198       Last changed: $Date: 2018-02-14 21:09:16 +0100 (Wed, 14 Feb 2018) $
199

SOURCE CODE

201       Available at: r.in.wms source code (history)
202
203       Main index | Raster index | Topics index | Keywords index  |  Graphical
204       index | Full index
205
206       © 2003-2019 GRASS Development Team, GRASS GIS 7.6.0 Reference Manual
207
208
209
210GRASS 7.6.0                                                        r.in.wms(1)
Impressum