v.in.wfs.1 3.59 KB
Newer Older
xuebingbing's avatar
xuebingbing committed
1
.TH v.in.wfs 1 "" "GRASS 7.8.5" "GRASS GIS User's Manual"
xuebingbing's avatar
xuebingbing committed
2 3 4 5 6 7 8 9 10
.SH NAME
\fI\fBv.in.wfs.py\fR\fR  \- Imports GetFeature from a WFS server.
.SH KEYWORDS
vector, import, OGC web services, OGC WFS
.SH SYNOPSIS
\fBv.in.wfs.py\fR
.br
\fBv.in.wfs.py \-\-help\fR
.br
xuebingbing's avatar
xuebingbing committed
11
\fBv.in.wfs.py\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]
xuebingbing's avatar
xuebingbing committed
12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58
.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)
xuebingbing's avatar
xuebingbing committed
59 60 61 62 63 64
.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
xuebingbing's avatar
xuebingbing committed
65 66 67 68
.SH DESCRIPTION
\fIv.in.wfs\fR imports OGC WFS maps (Web Feature Service) from
external servers.
.SH EXAMPLES
xuebingbing's avatar
xuebingbing committed
69 70
.SS WFS import without credentials
Import of Copernicus Sentinel\-2 satellite scene footprints:
xuebingbing's avatar
xuebingbing committed
71 72 73 74 75
.PP
.br
.nf
\fC
# run in Latitude\-Longitude location (EPGS code 4326):
xuebingbing's avatar
xuebingbing committed
76 77
# download \(dqsentinel:mgrs\(dq layer:
v.in.wfs url=\(dqhttps://geoserver.mundialis.de/geoserver/sentinel/wfs?\(dq name=\(dqsentinel:mgrs\(dq output=sentinel2_mgrs
xuebingbing's avatar
xuebingbing committed
78 79
\fR
.fi
xuebingbing's avatar
xuebingbing committed
80
.SS WFS import with API key
xuebingbing's avatar
xuebingbing committed
81 82 83 84 85 86 87 88 89 90
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
xuebingbing's avatar
xuebingbing committed
91
# download list of available layers to wms_capabilities.xml
xuebingbing's avatar
xuebingbing committed
92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109
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,
xuebingbing's avatar
xuebingbing committed
110
v.import,
xuebingbing's avatar
xuebingbing committed
111 112 113 114 115 116 117 118 119 120 121 122 123 124 125
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
xuebingbing's avatar
xuebingbing committed
126
© 2003\-2020
xuebingbing's avatar
xuebingbing committed
127
GRASS Development Team,
xuebingbing's avatar
xuebingbing committed
128
GRASS GIS 7.8.5 Reference Manual