.TH v.in.wfs 1grass "" "GRASS 7.2.0" "Grass User's Manual"
.SH NAME
\fI\fBv.in.wfs\fR\fR  \- Imports GetFeature from a WFS server.
.SH KEYWORDS
vector, import, OGC web services
.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]   [\-\-\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)
.SH DESCRIPTION
\fIv.in.wfs\fR imports OGC WFS maps (Web Feature Service) from
external servers.
.SH EXAMPLES
Import of world cities with population > 1 million:
.PP
.br
.nf
\fC
# run in Latitude\-Longitude location (EPGS code 4326):
# download geonam_gt1M layer:
v.in.wfs \(rs
  url=\(dqhttp://mapserver.flightgear.org/ms?Service=WFS&request=GetFeature&version=1.0.0\(dq \(rs
  name=geonam_gt1M output=geonam_gt1M
\fR
.fi
.PP
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 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.in.ogr
\fR
.SH AUTHORS
Markus Neteler, Hamish Bowman
.PP
\fILast changed: $Date: 2013\-04\-13 17:23:39 +0200 (Sat, 13 Apr 2013) $\fR
.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\-2016
GRASS Development Team,
GRASS GIS 7.2.0 Reference Manual