OpenLayers v6.15.1 API - Class: GML32

new GML32(opt_options) format/GML32.js, line 20

Name Type Description

options

Optional configuration object.

Name	Type	Description
`featureNS`	Object.<string, string> \| string \| undefined	Feature namespace. If not defined will be derived from GML. If multiple feature types have been configured which come from different feature namespaces, this will be an object with the keys being the prefixes used in the entries of featureType array. The values of the object will be the feature namespaces themselves. So for instance there might be a featureType item `topp:states` in the `featureType` array and then there will be a key `topp` in the featureNS object with value `http://www.openplans.org/topp`.
`featureType`	Array.<string> \| string \| undefined	Feature type(s) to parse. If multiple feature types need to be configured which come from different feature namespaces, `featureNS` will be an object with the keys being the prefixes used in the entries of featureType array. The values of the object will be the feature namespaces themselves. So for instance there might be a featureType item `topp:states` and then there will be a key named `topp` in the featureNS object with value `http://www.openplans.org/topp`.
`srsName`	string	srsName to use when writing geometries.
`surface`	boolean (defaults to false)	Write gml:Surface instead of gml:Polygon elements. This also affects the elements in multi-part geometries.
`curve`	boolean (defaults to false)	Write gml:Curve instead of gml:LineString elements. This also affects the elements in multi-part geometries.
`multiCurve`	boolean (defaults to true)	Write gml:MultiCurve instead of gml:MultiLineString. Since the latter is deprecated in GML 3.
`multiSurface`	boolean (defaults to true)	Write gml:multiSurface instead of gml:MultiPolygon. Since the latter is deprecated in GML 3.
`schemaLocation`	string \| undefined	Optional schemaLocation to use when writing out the GML, this will override the default provided.
`hasZ`	boolean (defaults to false)	If coordinates have a Z value.

Extends

module:ol/format/GML3~GML3

Methods

readFeature(source, opt_options){module:ol/Feature~Feature} inherited format/XMLFeature.js, line 43

Read a single feature.

Name Type Description

source

Document | Element | Object | string

Source.

options

Read options.

Name	Type	Description
`dataProjection`	module:ol/proj~ProjectionLike \| undefined	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 no `dataProjection` is set for a format, the features will not be reprojected.
`extent`	module:ol/extent~Extent \| undefined	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` with `TILE_PIXELS` as `units` and the tile's pixel extent as `extent` needs to be provided.
`featureProjection`	module:ol/proj~ProjectionLike \| undefined	Projection of the feature geometries created by the format reader. If not provided, features will be returned in the `dataProjection`.

Returns:

Feature.

readFeatures(source, opt_options){Array.<module:ol/Feature~Feature>} inherited format/XMLFeature.js, line 93

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 \| undefined	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 no `dataProjection` is set for a format, the features will not be reprojected.
`extent`	module:ol/extent~Extent \| undefined	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` with `TILE_PIXELS` as `units` and the tile's pixel extent as `extent` needs to be provided.
`featureProjection`	module:ol/proj~ProjectionLike \| undefined	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 format/XMLFeature.js, line 196

Read the projection from the source.

Name	Type	Description
`source`	Document \| Element \| Object \| string	Source.

Returns:

Projection.

writeFeatures(features, opt_options){string} inherited format/GML3.js, line 1206

Encode an array of features in GML 3.1.1 Simple Features.

Name Type Description

features

Array.<module:ol/Feature~Feature>

Features.

options

Options.

Name	Type	Description
`dataProjection`	module:ol/proj~ProjectionLike \| undefined	Projection of the data we are writing. If not provided, the `dataProjection` of the format is assigned (where set). If no `dataProjection` is set for a format, the features will be returned in the `featureProjection`.
`featureProjection`	module:ol/proj~ProjectionLike \| undefined	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 \| undefined	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. If `false`, 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 \| undefined	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.

writeFeaturesNode(features, opt_options){Element} inherited format/GML3.js, line 1019

Encode an array of features in the GML 3.1.1 format as an XML node.

Name Type Description

features

Array.<module:ol/Feature~Feature>

Features.

options

Options.

Name	Type	Description
`dataProjection`	module:ol/proj~ProjectionLike \| undefined	Projection of the data we are writing. If not provided, the `dataProjection` of the format is assigned (where set). If no `dataProjection` is set for a format, the features will be returned in the `featureProjection`.
`featureProjection`	module:ol/proj~ProjectionLike \| undefined	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 \| undefined	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. If `false`, 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 \| undefined	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:

Node.

writeGeometryNode(geometry, opt_options){Node} inherited format/GML3.js, line 992

Encode a geometry in GML 3.1.1 Simple Features.

Name Type Description

geometry

module:ol/geom/Geometry~Geometry

Geometry.

options

Options.

Name	Type	Description
`dataProjection`	module:ol/proj~ProjectionLike \| undefined	Projection of the data we are writing. If not provided, the `dataProjection` of the format is assigned (where set). If no `dataProjection` is set for a format, the features will be returned in the `featureProjection`.
`featureProjection`	module:ol/proj~ProjectionLike \| undefined	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 \| undefined	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. If `false`, 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 \| undefined	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:

Node.