-
Name Type Description options
Optional configuration object.
Name Type Description featureNS
Object.<string, string> | string The namespace URI used for features.
featureType
Array.<string> | string The feature type to parse. Only used for read operations.
gmlFormat
module:ol/format/GMLBase~GMLBase The GML format to use to parse the response. Default is
ol/format/GML2
for WFS 1.0.0,ol/format/GML3
for WFS 1.1.0 andol/format/GML32
for WFS 2.0.0.schemaLocation
string Optional schemaLocation to use for serialization, this will override the default.
version
string (defaults to '1.1.0') WFS version to use. Can be either
1.0.0
,1.1.0
or2.0.0
.
Extends
Methods
-
Read a single feature.
Name Type Description source
Document | Element | Object | string Source.
options
Read options.
Name Type Description dataProjection
module:ol/proj~ProjectionLike Projection of the data we are reading. If not provided, the projection will be derived from the data (where possible) or the
dataProjection
of the format is assigned (where set). If the projection can not be derived from the data and if nodataProjection
is set for a format, the features will not be reprojected.extent
module:ol/extent~Extent Tile extent in map units of the tile being read. This is only required when reading data with tile pixels as geometry units. When configured, a
dataProjection
withTILE_PIXELS
asunits
and the tile's pixel extent asextent
needs to be provided.featureProjection
module:ol/proj~ProjectionLike Projection of the feature geometries created by the format reader. If not provided, features will be returned in the
dataProjection
.Returns:
Feature.
-
readFeatureCollectionMetadata(source){module:ol/format/WFS~FeatureCollectionMetadata|undefined}
-
Read feature collection metadata of the source.
Name Type Description source
Document | Element | Object | string Source.
Returns:
FeatureCollection metadata.
-
readFeatures(source, opt_options){Array.<module:ol/Feature~Feature>} inherited
-
Read all features from a feature collection.
Name Type Description source
Document | Element | Object | string Source.
options
Options.
Name Type Description dataProjection
module:ol/proj~ProjectionLike Projection of the data we are reading. If not provided, the projection will be derived from the data (where possible) or the
dataProjection
of the format is assigned (where set). If the projection can not be derived from the data and if nodataProjection
is set for a format, the features will not be reprojected.extent
module:ol/extent~Extent Tile extent in map units of the tile being read. This is only required when reading data with tile pixels as geometry units. When configured, a
dataProjection
withTILE_PIXELS
asunits
and the tile's pixel extent asextent
needs to be provided.featureProjection
module:ol/proj~ProjectionLike Projection of the feature geometries created by the format reader. If not provided, features will be returned in the
dataProjection
.Returns:
Features.
-
readProjection(source){module:ol/proj/Projection~Projection} inherited
-
Read the projection from the source.
Name Type Description source
Document | Element | Object | string Source.
Returns:
Projection.
-
readTransactionResponse(source){module:ol/format/WFS~TransactionResponse|undefined}
-
Read transaction response of the source.
Name Type Description source
Document | Element | Object | string Source.
Returns:
Transaction response.
-
Encode an array of features as string.
Name Type Description features
Array.<module:ol/Feature~Feature> Features.
options
Write options.
Name Type Description dataProjection
module:ol/proj~ProjectionLike Projection of the data we are writing. If not provided, the
dataProjection
of the format is assigned (where set). If nodataProjection
is set for a format, the features will be returned in thefeatureProjection
.featureProjection
module:ol/proj~ProjectionLike Projection of the feature geometries that will be serialized by the format writer. If not provided, geometries are assumed to be in the
dataProjection
if that is set; in other words, they are not transformed.rightHanded
boolean When writing geometries, follow the right-hand rule for linear ring orientation. This means that polygons will have counter-clockwise exterior rings and clockwise interior rings. By default, coordinates are serialized as they are provided at construction. If
true
, the right-hand rule will be applied. Iffalse
, the left-hand rule will be applied (clockwise for exterior and counter-clockwise for interior rings). Note that not all formats support this. The GeoJSON format does use this property when writing geometries.decimals
number Maximum number of decimal places for coordinates. Coordinates are stored internally as floats, but floating-point arithmetic can create coordinates with a large number of decimal places, not generally wanted on output. Set a number here to round coordinates. Can also be used to ensure that coordinates read in can be written back out with the same number of decimals. Default is no rounding.
Returns:
Result.
-
Encode format as WFS
GetFeature
and return the Node.Name Type Description options
Options.
Name Type Description featureNS
string The namespace URI used for features.
featurePrefix
string The prefix for the feature namespace.
featureTypes
Array.<(string|module:ol/format/WFS~FeatureType)> The feature type names or FeatureType objects to define a unique bbox filter per feature type name (in this case, options
bbox
andgeometryName
are ignored.).srsName
string SRS name. No srsName attribute will be set on geometries when this is not provided.
handle
string Handle.
outputFormat
string Output format.
maxFeatures
number Maximum number of features to fetch.
geometryName
string Geometry name to use in a BBOX filter.
propertyNames
Array.<string> Optional list of property names to serialize.
viewParams
string viewParams GeoServer vendor parameter.
startIndex
number Start index to use for WFS paging. This is a WFS 2.0 feature backported to WFS 1.1.0 by some Web Feature Services.
count
number Number of features to retrieve when paging. This is a WFS 2.0 feature backported to WFS 1.1.0 by some Web Feature Services. Please note that some Web Feature Services have repurposed
maxfeatures
instead.bbox
module:ol/extent~Extent Extent to use for the BBOX filter. The
geometryName
option must be set.filter
module:ol/format/filter/Filter~Filter Filter condition. See
module:ol/format/Filter
for more information.resultType
string Indicates what response should be returned, E.g.
hits
only includes thenumberOfFeatures
attribute in the response and no features.Returns:
Result.
-
Encode format as WFS
Transaction
and return the Node.Name Type Description inserts
Array.<module:ol/Feature~Feature> The features to insert.
updates
Array.<module:ol/Feature~Feature> The features to update.
deletes
Array.<module:ol/Feature~Feature> The features to delete.
options
Write options.
Name Type Description featureNS
string The namespace URI used for features.
featurePrefix
string The prefix for the feature namespace.
featureType
string The feature type name.
srsName
string SRS name. No srsName attribute will be set on geometries when this is not provided.
handle
string Handle.
hasZ
boolean Must be set to true if the transaction is for a 3D layer. This will allow the Z coordinate to be included in the transaction.
nativeElements
Array.<Object> Native elements. Currently not supported.
gmlOptions
module:ol/format/GMLBase~Options GML options for the WFS transaction writer.
version
string (defaults to '1.1.0') WFS version to use for the transaction. Can be either
1.0.0
,1.1.0
or2.0.0
.Returns:
Result.