# info.description
Have you ever wondered where the wine that you are drinking comes from? If the wine comes from the wine-growing regions Mosel, Nahe, Rheinhessen, Pfalz, Ahr, or Mittelrhein you can find this information in this API.

The dataset shared by this API is the vineyard register (Weinbergsrolle) of Rhineland-Palatinate, available under an open-data license. It is managed by the Chamber of Agriculture of Rhineland-Palatinate (Landwirtschaftskammer RLP).
© Landwirtschaftskammer RLP (2020), dl-de/by-2-0, weinlagen.lwk-rlp.de; Regelungen zu Gewährleistung und Haftung

This API is a demo for APIs that can be deployed using ldproxy based on the OGC API standards developed by the Open Geospatial Consortium. A description how to set this API is available here.

# info.license.name
Datenlizenz Deutschland - Namensnennung - Version 2.0

# paths./.get.description
The landing page provides links to the API definition (link relations `service-desc` and `service-doc`), the Conformance declaration (path `/conformance`, link relation `conformance`), and other resources in the API.

# paths./.get.responses.200.description
The operation was executed successfully.

# paths./conformance.get.description
The URIs of all conformance classes supported by the server. This information is provided to support 'generic' clients that want to access multiple OGC API implementations - and not 'just' a specific API. For clients accessing only a single API, this information is in general not relevant and the OpenAPI definition details the required information about the API.

# paths./conformance.get.responses.200.description
The operation was executed successfully.

# paths./collections.get.summary
feature collections in the dataset 'Vineyards in Rhineland-Palatinate, Germany'

# paths./collections.get.description
The dataset is organized in feature collections. This resource provides information about and access to the feature collections.
The response contains the list of collections. For each collection, a link to the items in the collection (path `/collections/{collectionId}/items`, link relation `items`) as well as key information about the collection.
This information includes:

* A local identifier for the collection that is unique for the dataset;
* A title and description for the collection;
* An indication of the spatial and temporal extent of the data in the collection;
* A list of coordinate reference systems (CRS) in which geometries may be returned by the server. The first CRS is the default coordinate reference system (the default is always WGS 84 with axis order longitude/latitude);
* The CRS in which the spatial geometries are stored in the data source (if data is requested in this CRS, the geometries are returned without any coordinate conversion);
* An indicator about the type of the items in the collection (the default value is 'feature').

# paths./collections.get.responses.200.description
The operation was executed successfully.

# paths./collections/vineyards.get.description
Information about the feature collection with id 'vineyards'. The response contains a link to the items in the collection (path `/collections/{collectionId}/items`,link relation `items`) as well as key information about the collection. This information includes:

* A local identifier for the collection that is unique for the dataset;
* A title and description for the collection;
* An indication of the spatial and temporal extent of the data in the collection;
* A list of coordinate reference systems (CRS) in which geometries may be returned by the server. The first CRS is the default coordinate reference system (the default is always WGS 84 with axis order longitude/latitude);
* The CRS in which the spatial geometries are stored in the data source (if data is requested in this CRS, the geometries are returned without any coordinate conversion);
* An indicator about the type of the items in the collection (the default value is 'feature').

# paths./collections/vineyards.get.responses.200.description
The operation was executed successfully.

# paths./collections/vineyards/items/{featureId}.get.summary
retrieve a feature in the feature collection 'vineyards'

# paths./collections/vineyards/items/{featureId}.get.description
Fetch the feature with id `{featureId}`.

# paths./collections/vineyards/items/{featureId}.get.responses.200.description
The operation was executed successfully.

# paths./collections/vineyards/items/{featureId}.get.responses.200.headers.Content-Bounding-Box.description
The bounding box of the coordinates in the response. The coordinates are in the coordinate reference system provided in the 'Content-Crs' header. The header is only provided, if the response is not streamed.

# paths./collections/vineyards/items/{featureId}.get.responses.200.headers.Content-Crs.description
The coordinate reference system of coordinates in the response.

# paths./collections/vineyards/items/{featureId}.get.responses.200.headers.Content-Temporal-Extent.description
The temporal extent of the features in the response. The values are seconds since epoch. The header is only provided, if the response is not streamed.

# paths./collections/vineyards/items.get.summary
retrieve features in the feature collection 'vineyards'

# paths./collections/vineyards/items.get.description
The response is a document consisting of features in the collection. The features included in the response are determined by the server based on the query parameters of the request.

To support access to larger collections without overloading the client, the API supports paged access with links to the next page, if more features are selected that the page size (maximum page size is 10000).

The `bbox` and `datetime` parameter can be used to select only a subset of the features in the collection (the features that are in the bounding box or time interval). The `bbox` parameter matches all features in the collection that are not associated with a location, too. The `datetime` parameter matches all features in the collection that are not associated with a time stamp or interval, too. The `limit` parameter may be used to control the subset of the selected features that should be returned in the response, the page size. Each page may include information about the number of selected and returned features (`numberMatched` and `numberReturned`) as well as links to support paging (link relation `next`).

See the details of this operation for a description of additional query parameters supported by this resource.

# paths./collections/vineyards/items.get.responses.200.description
The operation was executed successfully.

# paths./collections/vineyards/items.get.responses.200.headers.Content-Bounding-Box.description
The bounding box of the coordinates in the response. The coordinates are in the coordinate reference system provided in the 'Content-Crs' header. The header is only provided, if the response is not streamed.

# paths./collections/vineyards/items.get.responses.200.headers.Content-Crs.description
The coordinate reference system of coordinates in the response.

# paths./collections/vineyards/items.get.responses.200.headers.Content-Temporal-Extent.description
The temporal extent of the features in the response. The values are seconds since epoch. The header is only provided, if the response is not streamed.

# paths./collections/vineyards/queryables.get.summary
retrieve the queryables of the feature collection 'vineyards'

# paths./collections/vineyards/queryables.get.description
The Queryables resources identifies the properties that can be referenced in filter expressions to select specific features that meet the criteria identified in the filter. The response is a JSON Schema document that describes a single JSON object where each property is a queryable.

Note: The queryables schema does not specify a schema of any object that can be retrieved from the API.

The descriptive metadata (title and description of the property) as well as the schema information (data type and constraints like a list of allowed values or minimum/maxmimum values are provided to support clients to constructmeaningful queries for the data.

# paths./collections/vineyards/queryables.get.responses.200.description
The operation was executed successfully.

# paths./tiles.get.summary
retrieve a list of the available tile sets

# paths./tiles.get.description
This operation fetches the list of multi-layer tile sets supported by this API.

# paths./tiles.get.responses.200.description
The operation was executed successfully.

# paths./tiles/{tileMatrixSetId}.get.description
This operation fetches information about a tile set.

# paths./tiles/{tileMatrixSetId}.get.responses.200.description
The operation was executed successfully.

# paths./tiles/{tileMatrixSetId}/{tileMatrix}/{tileRow}/{tileCol}.get.summary
fetch a tile with multiple layers, one per collection

# paths./tiles/{tileMatrixSetId}/{tileMatrix}/{tileRow}/{tileCol}.get.description
The tile in the requested tiling scheme ('{tileMatrixSetId}'), on the requested zoom level ('{tileMatrix}'), with the requested grid coordinates ('{tileRow}', '{tileCol}') is returned. The tile has one layer per collection with all selected features in the bounding box of the tile with the requested properties.

# paths./tiles/{tileMatrixSetId}/{tileMatrix}/{tileRow}/{tileCol}.get.responses.200.description
The operation was executed successfully.

# paths./collections/{collectionId}/tiles.get.summary
retrieve a list of the available tile sets

# paths./collections/{collectionId}/tiles.get.description
This operation fetches the list of tile sets available for this collection.

# paths./collections/{collectionId}/tiles.get.responses.200.description
The operation was executed successfully.

# paths./collections/{collectionId}/tiles/{tileMatrixSetId}.get.description
This operation fetches information about a tile set.

# paths./collections/{collectionId}/tiles/{tileMatrixSetId}.get.responses.200.description
The operation was executed successfully.

# paths./collections/{collectionId}/tiles/{tileMatrixSetId}/{tileMatrix}.get.summary
fetch a tile of the collection '{collectionId}'

# paths./collections/{collectionId}/tiles/{tileMatrixSetId}/{tileMatrix}.get.description
The tile in the requested tiling scheme ('{tileMatrixSetId}'), on the requested zoom level ('{tileMatrix}'), with the requested grid coordinates ('{tileRow}', '{tileCol}') is returned. The tile has a single layer with all selected features in the bounding box of the tile with the requested properties.

# paths./collections/{collectionId}/tiles/{tileMatrixSetId}/{tileMatrix}.get.responses.200.description
The operation was executed successfully.

# paths./tileMatrixSets/{tileMatrixSetId}.get.summary
fetch information about the tiling scheme `{tileMatrixSetId}`

# paths./tileMatrixSets/{tileMatrixSetId}.get.description
Returns the definition of the tiling scheme according to the [OGC Two Dimensional Tile Matrix Set standard](https://docs.ogc.org/is/17-083r2/17-083r2.html).

# paths./tileMatrixSets/{tileMatrixSetId}.get.responses.200.description
The operation was executed successfully.

# paths./tileMatrixSets.get.summary
retrieve a list of the available tiling schemes

# paths./tileMatrixSets.get.description
This operation fetches the set of tiling schemes supported by this API. For each tiling scheme the id, a title and the link to the tiling scheme object is provided.

# paths./tileMatrixSets.get.responses.200.description
The operation was executed successfully.

# components.schemas.featureGeoJson_vineyards.description
The vineyard register constitutes the authorized list of names of single vineyards, vineyards clusters (Großlagen), sub-regions (Bereiche) and wine-growing regions (Anbaugebiete) for the protected designation of origin for wines in the German state Rhineland-Palatinate. It is managed by the Chamber of Agriculture of Rhineland-Palatinate (Landwirtschaftskammer RLP).<br>
The data for each vineyard includes the vineyard register number, the wine-growing region, the sub-region, the vineyard cluster, the name of the single vineyard, the village(s), the cadastral district(s) and the area with vines in hectares. The six-digit vineyard register number contains in the first digit the wine-growing region, in the second digit the sub-region, in the third and fourth digit the vineyard cluster and in the fifth and sixth digit the single vineyard.

# components.parameters.access_token.description
Set the authorization token for the request. If no value is provided, the standard HTTP rules apply, i.e., the authorization header will be used to determine the token.

# components.parameters.fCommon.description
Select the output format of the response. If no value is provided, the standard HTTP rules apply, i.e., the accept header will be used to determine the format.

# components.parameters.fCollections.description
Select the output format of the response. If no value is provided, the standard HTTP rules apply, i.e., the accept header will be used to determine the format.

# components.parameters.fCollection.description
Select the output format of the response. If no value is provided, the standard HTTP rules apply, i.e., the accept header will be used to determine the format.

# components.parameters.featureId.description
The local identifier of a feature, unique within the feature collection.

# components.parameters.crsFeatures_vineyards.description
The coordinate reference system of the response geometries. Default is WGS84 longitude/latitude (with or without height).

# components.parameters.fFeatures.description
Select the output format of the response. If no value is provided, the standard HTTP rules apply, i.e., the accept header will be used to determine the format.

# components.parameters.bbox.description
Only features that have a geometry that intersects the bounding box are selected. The bounding box is provided as four numbers:

* Lower left corner, coordinate axis 1 
* Lower left corner, coordinate axis 2 
* Upper right corner, coordinate axis 1 
* Upper right corner, coordinate axis 2 
The coordinate reference system of the values is WGS 84 longitude/latitude (http://www.opengis.net/def/crs/OGC/1.3/CRS84) unless a different coordinate reference system is specified in the parameter `bbox-crs`. For WGS 84 longitude/latitude the values are in most cases the sequence of minimum longitude, minimum latitude, maximum longitude and maximum latitude. However, in cases where the box spans the antimeridian the first value (west-most box edge) is larger than the third value (east-most box edge).

# components.parameters.bbox-crsFeatures_vineyards.description
The coordinate reference system of the `bbox` parameter. Default is WGS84 longitude/latitude.

# components.parameters.datetime.description
Either a date-time or an interval. Date and time expressions adhere to RFC 3339.
Intervals may be bounded or half-bounded (double-dots at start or end).
Examples:

* A date-time: "2018-02-12T23:20:50Z"
* A bounded interval: "2018-02-12T00:00:00Z/2018-03-18T12:31:12Z"
* Half-bounded intervals: "2018-02-12T00:00:00Z/.." or "../2018-03-18T12:31:12Z"

Only features that have a temporal property that intersects the value of `datetime` are selected.

# components.parameters.limitFeatures_vineyards.description
The optional limit parameter limits the number of items that are presented in the response document. Only items are counted that are on the first level of the collection in the response document. Nested objects contained within the explicitly requested items are not counted. If the value is higher than the maximum page size, the maximum page size is used instead of the parameter value.

# components.parameters.offsetFeatures.description
The optional offset parameter identifies the index of the first feature in the response in the overall result set.

# components.parameters.registerId_vineyards.description
Filter the collection by property 'registerId' (Vineyard register number).

# components.parameters.name_vineyards.description
Filter the collection by property 'name' (Vineyard name).

# components.parameters.area_ha_vineyards.description
Filter the collection by property 'area_ha' (Area in hectares).

# components.parameters.region_vineyards.description
Filter the collection by property 'region' (Wine-growing region).

# components.parameters.subregion_vineyards.description
Filter the collection by property 'subregion' (Sub-region (Bereich)).

# components.parameters.cluster_vineyards.description
Filter the collection by property 'cluster' (Vineyard cluster (Großlage)).

# components.parameters.village_vineyards.description
Filter the collection by property 'village' (Village(s)).

# components.parameters.searchfield1_vineyards.description
Filter the collection by property 'searchfield1' (Search field (option 1)).

# components.parameters.searchfield2_vineyards.description
Filter the collection by property 'searchfield2' (Search field (option 2)).

# components.parameters.date_vineyards.description
Filter the collection by property 'date' (Validity date).

# components.parameters.fQueryables.description
Select the output format of the response. If no value is provided, the standard HTTP rules apply, i.e., the accept header will be used to determine the format.

# components.parameters.fTileSets.description
Select the output format of the response. If no value is provided, the standard HTTP rules apply, i.e., the accept header will be used to determine the format.

# components.parameters.tileMatrixSetIdTiles.description
The local identifier of a tile matrix set, unique within the API.

# components.parameters.fTileSet.description
Select the output format of the response. If no value is provided, the standard HTTP rules apply, i.e., the accept header will be used to determine the format.

# components.parameters.tileCol.description
Column index of the tile on the selected zoom level. See http://www.maptiler.org/google-maps-coordinates-tile-bounds-projection/ for more information about Level, Row and Column in the Google Maps tiling scheme (WebMercatorQuad). Example: In the WebMercatorQuad tiling scheme Ireland is fully within the tile with the following values: Level 5, Row 10 and Col 15

# components.parameters.tileMatrix.description
Zoom level of the tile. See http://www.maptiler.org/google-maps-coordinates-tile-bounds-projection/ for more information about Level, Row and Column in the Google Maps tiling scheme (WebMercatorQuad). Example: In the WebMercatorQuad tiling scheme Ireland is fully within the tile with the following values: Level 5, Row 10 and Col 15

# components.parameters.tileRow.description
Row index of the tile on the selected zoom level. See http://www.maptiler.org/google-maps-coordinates-tile-bounds-projection/ for more information about Level, Row and Column in the Google Maps tiling scheme (WebMercatorQuad). Example: In the WebMercatorQuad tiling scheme Ireland is fully within the tile with the following values: Level 5, Row 10 and Col 15

# components.parameters.collections.description
The collections that should be included. The parameter value is a comma-separated list of collection names.

# components.parameters.fTileDataset.description
Select the output format of the response. If no value is provided, the standard HTTP rules apply, i.e., the accept header will be used to determine the format.

# components.parameters.collectionIdTiles.description
The local identifier of a feature collection.

# components.parameters.fTileCollection.description
Select the output format of the response. If no value is provided, the standard HTTP rules apply, i.e., the accept header will be used to determine the format.

# components.parameters.limitTile.description
The optional limit parameter limits the number of features that are included in the tile.

# components.parameters.tileMatrixSetIdTileMatrixSets.description
The local identifier of a tile matrix set, unique within the API.

# components.parameters.fTileMatrixSets.description
Select the output format of the response. If no value is provided, the standard HTTP rules apply, i.e., the accept header will be used to determine the format.