Profile - Position CRS

speccustomimplproposal

Profiles for the reference system of the positions in the response.

Scope

One of two profiles can be used to select the reference system of the positions in the response.

With "crs-original", positions are represented as recorded. A position of a geometry property with a crsVariants declaration in the provider schema is returned in its original reference system, identified by the stored verbatim CRS identifier. This includes positions in reference systems that cannot be expressed as the CRS of the response, such as realizations that map to the same coordinate reference system or 1D vertical reference systems. Every other position is returned in the CRS in which the feature provider stores it, that is, in the storage CRS of the collection.

With "crs-requested" (the default), the position of the primary geometry property is returned in the requested CRS in all feature encodings; a feature whose position cannot be represented in the requested CRS (for example, a position in a 1D vertical reference system) is returned without a geometry.

The CRS that "crs-original" selects is a fallback for the default CRS of the API: if the request includes a crs parameter, the positions are returned in that CRS, except for the positions of a geometry property with a crsVariants declaration, which are always returned as recorded. In the HTML representation the profile is ignored, as is the crs parameter.

The original reference system of a position of a geometry property with a crsVariants declaration is represented in GML (the position element carries the original identifier as srsName, 1D positions are encoded with srsDimension="1") and in GeoJSON with the JSON-FG extensions (place carries the original position with the identifier in coordRefSys; for a 1D position, the vertical coordinate and the identifier appear in properties). Feature encodings that cannot represent positions in other reference systems (for example, plain GeoJSON) return such positions in the CRS of the response.

Configuration

Options

Name	Default	Description	Type	Since
buildingBlock		Always PROFILE_CRS.	string	v2.0
enabled	true	Enable the building block?	boolean	v2.0

This building block does not require or support any additional configuration files.

Examples

- buildingBlock: PROFILE_CRS
 enabled: true