.TH v.in.wfs 1grass "" "GRASS 7.8.5" "GRASS GIS User's Manual"
.SH NAME
\fI\fBv.in.wfs\fR\fR  \- Imports GetFeature from a WFS server.
.SH KEYWORDS
vector, import, OGC web services, OGC WFS
.SH SYNOPSIS
\fBv.in.wfs\fR
.br
\fBv.in.wfs \-\-help\fR
.br
\fBv.in.wfs\fR [\-\fBlr\fR] \fBurl\fR=\fIstring\fR \fBoutput\fR=\fIname\fR  [\fBname\fR=\fIstring\fR[,\fIstring\fR,...]]   [\fBsrs\fR=\fIstring\fR]   [\fBmaximum_features\fR=\fIinteger\fR]   [\fBstart_index\fR=\fIinteger\fR]   [\fBusername\fR=\fIstring\fR]   [\fBpassword\fR=\fIstring\fR]   [\-\-\fBoverwrite\fR]  [\-\-\fBhelp\fR]  [\-\-\fBverbose\fR]  [\-\-\fBquiet\fR]  [\-\-\fBui\fR]
.SS Flags:
.IP "\fB\-l\fR" 4m
.br
Download server capabilities to \(cqwms_capabilities.xml\(cq in the current directory and exit
.IP "\fB\-r\fR" 4m
.br
Restrict fetch to features which touch the current region
.IP "\fB\-\-overwrite\fR" 4m
.br
Allow output files to overwrite existing files
.IP "\fB\-\-help\fR" 4m
.br
Print usage summary
.IP "\fB\-\-verbose\fR" 4m
.br
Verbose module output
.IP "\fB\-\-quiet\fR" 4m
.br
Quiet module output
.IP "\fB\-\-ui\fR" 4m
.br
Force launching GUI dialog
.SS Parameters:
.IP "\fBurl\fR=\fIstring\fR \fB[required]\fR" 4m
.br
Base URL starting with \(cqhttp\(cq and ending in \(cq?\(cq
.IP "\fBoutput\fR=\fIname\fR \fB[required]\fR" 4m
.br
Name for output vector map
.IP "\fBname\fR=\fIstring[,\fIstring\fR,...]\fR" 4m
.br
Comma separated names of data layers to download
.IP "\fBsrs\fR=\fIstring\fR" 4m
.br
Specify alternate spatial reference system (example: EPSG:4326)
.br
The given code must be supported by the server, consult the capabilities file
.IP "\fBmaximum_features\fR=\fIinteger\fR" 4m
.br
Maximum number of features to download
.br
(default: unlimited)
.IP "\fBstart_index\fR=\fIinteger\fR" 4m
.br
Skip earlier feature IDs and start downloading at this one
.br
(default: start with the first feature)
.IP "\fBusername\fR=\fIstring\fR" 4m
.br
Username or file with username or environment variable name with username
.IP "\fBpassword\fR=\fIstring\fR" 4m
.br
Password or file with password or environment variable name with password
.SH DESCRIPTION
\fIv.in.wfs\fR imports OGC WFS maps (Web Feature Service) from
external servers.
.SH EXAMPLES
.SS WFS import without credentials
Import of Copernicus Sentinel\-2 satellite scene footprints:
.PP
.br
.nf
\fC
# run in Latitude\-Longitude location (EPGS code 4326):
# download \(dqsentinel:mgrs\(dq layer:
v.in.wfs url=\(dqhttps://geoserver.mundialis.de/geoserver/sentinel/wfs?\(dq name=\(dqsentinel:mgrs\(dq output=sentinel2_mgrs
\fR
.fi
.SS WFS import with API key
Download 25 ship wrecks from LINZ data service:
.br
(first create yourself a free API key at
http://data.linz.govt.nz/p/web\-services/)
.PP
.br
.nf
\fC
# run in LatLong location:
URL=\(cqhttp://wfs.data.linz.govt.nz/<PUT YOUR API KEY HERE>/wfs?\(cq
# download list of available layers to wms_capabilities.xml
v.in.wfs \-l url=\(dq$URL\(dq
\fR
.fi
From that file we learn that the shipwreck layer is called \(dqv:x633\(dq
and that EPSG code 4326 (LatLong WGS84) is a supported SRS for this data layer.
.br
.nf
\fC
v.in.wfs url=\(dq$URL\(dq output=linz_hydro_25_wrecks name=\(dqv:x633\(dq srs=\(dqEPSG:4326\(dq max=25
\fR
.fi
.SH REQUIREMENTS
The OGR library on the system needs to be compiled with Xerces C++ XML
Parser support (for GML).
.SH SEE ALSO
\fI
g.region,
r.in.wms,
v.import,
v.in.ogr
\fR
.SH AUTHORS
Markus Neteler, Hamish Bowman
.SH SOURCE CODE
.PP
Available at: v.in.wfs source code (history)
.PP
Main index |
Vector index |
Topics index |
Keywords index |
Graphical index |
Full index
.PP
© 2003\-2020
GRASS Development Team,
GRASS GIS 7.8.5 Reference Manual