1r.in.wms(1) Grass User's Manual r.in.wms(1)
2
3
4
6 r.in.wms - Downloads and imports data from WMS/WMTS/NASA OnEarth
7 server.
8
10 raster, import, OGC web services
11
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
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
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
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
182 r.in.wms requires the gdalwarp utility from the GDAL/OGR library.
183
185 · OGC WMS
186
187 · OGC WMTS
188
190 r.in.gdal, r.patch, r.colors, r.composite, v.in.wfs
191
192 See also WMS support in wxGUI.
193
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:54 +0100 (Wed, 14 Feb 2018) $
199
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.4.4 Reference Manual
207
208
209
210GRASS 7.4.4 r.in.wms(1)