Feature Collections

specstableimplmature

Feature Collections.

Umfang

Der Baustein Feature Collections ist für jede API mit einem Feature-Provider zu aktivieren. Es stellt die Ressourcen Collections und Collection bereit. Derzeit sind Feature Collections die einzige unterstützte Art von Collections.

Information

Zusätzliche Links zu einer bestimmten Feature Collection einzelnen können bei der Konfiguration der Collection angegeben werden.

Konformitätsklassen

"Feature Collections" implementiert alle Vorgaben der Konformitätsklasse "Core" von OGC API - Features - Part 1: Core 1.0.1open in new window für die zwei genannten Ressourcen.

Operationen

RessourcePfadMethodenFormateBeschreibung
Feature Collections
collections
GET
HTML, JSON, XML
Informationen über die Feature-Collection mit der ID '"+collectionId+"'. Die Antwort enthält einen Link zu den Elementen der Collection (Pfad /collections/{collectionId}/items,link relation items) sowie Schlüsselinformationen über die Collection.
Feature Collection
collections/{collectionId}
GET
HTML, JSON, XML
Informationen über die Feature-Collection mit der ID collectionIdì. Die Antwort enthält einen Link zu den Elementen der Collection (Pfad /collections/{collectionId}/items,link relation items`) sowie Schlüsselinformationen über die Collection.

Pfad-Parameter

NameRessourcenBeschreibung
collectionId
Feature Collection
Der Identifikator der Feature Collection.

Query Parameter

NameRessourcenBeschreibung
f
Collections
Wählt das Ausgabeformat der Antwort. Wenn kein Wert angegeben wird, gelten die Standard-HTTP Regeln, d.h. der "Accept"-Header wird zur Bestimmung des Formats verwendet.
f
Collection
Wählt das Ausgabeformat der Antwort. Wenn kein Wert angegeben wird, gelten die Standard-HTTP Regeln, d.h. der "Accept"-Header wird zur Bestimmung des Formats verwendet.

Konfiguration

Optionen

NameDefaultBeschreibungTypSeit
buildingBlock
Immer COLLECTIONS.
string
v3.1
caching
{}
Setzt feste Werte für HTTP-Caching-Header für die Ressourcen.
object
v3.1
enabled
true
Soll der Baustein aktiviert werden?
boolean
v3.1
additionalLinks
[]
Erlaubt es, zusätzliche Links in der Ressource Feature Collections zu ergänzen. Der Wert ist ein Array von Link-Objekten. Anzugeben sind jeweils mindestens die URI (href), der anzuzeigende Text (label) und die Link-Relation (rel).
array
v3.1
collectionIdAsParameter
false
Steuert, ob in der API-Definition jede Feature Collection und untergeordnete Ressourcen jeweils als einzelne Ressource aufgeführt wird (false), oder ob ein Pfad-Parameter collectionId verwendet wird und jede Ressource nur einmal in der Definition spezifiziert wird (true). Bei true wird die API-Definition einfacher und kürzer, aber das Schema ist nicht mehr Collection-spezifisch und Collection-spezifische Query-Parameter können nicht mehr in der API-Definition spezifiziert werden.
boolean
v3.1
collectionDefinitionsAreIdentical
false
Sofern im Fall von collectionIdAsParameter: true alle Collections ein strukturell identisches Schema besitzen und dieselben Queryables haben, kann mit dem Wert true gesteuert werden, dass in der API-Definition Schema und Queryables aus einer beliebigen Collection bestimmt werden.
boolean
v3.1

Beispiele


- buildingBlock: COLLECTIONS
  additionalLinks:
  - rel: related
    type: text/html
    title: 'Weinlagen-Online website (Provider: Landwirtschaftskammer Rheinland-Pfalz)'
    href: 'http://weinlagen.lwk-rlp.de/portal/weinlagen.html'
    hreflang: de
  - rel: related
    type: application/xml
    title: 'OGC Web Map Service with the data (Provider: Landwirtschaftskammer Rheinland-Pfalz)'
    href: 'http://weinlagen.lwk-rlp.de/cgi-bin/mapserv?map=/data/_map/weinlagen/einzellagen_rlp.map&service=WMS&request=GetCapabilities'
    hreflang: de
  - rel: related
    type: application/xml
    title: 'OGC Web Feature Service with the data (Provider: Landwirtschaftskammer Rheinland-Pfalz)'
    href: 'http://weinlagen.lwk-rlp.de/geoserver/lwk/ows?service=WFS&request=getcapabilities'
    hreflang: de
  - rel: enclosure
    type: application/x-shape
    title: 'Download the data as a shapefile (Provider: Landwirtschaftskammer Rheinland-Pfalz)'
    href: 'http://weinlagen.lwk-rlp.de/geoserver/lwk/ows?service=WFS&version=1.0.0&request=GetFeature&typeName=lwk:Weinlagen&outputFormat=shape-zip'
    hreflang: de