Features - Custom Extensions

speccustomimplproposal

POST für /items und Filterung durch Geometrie-Überschneidung.

Umfang

Das Modul Features - Custom Extensions ergänzt die Unterstützung der HTTP-Methode POST auf der Features-Ressource. Der Unterschied zum Aufruf mit GET ist, dass die Query-Parameter als Content im Aufruf übergeben werden. Dies kann aus zwei Gründen gewünscht sein:

• URLs sind in HTTP-Implementierungen in der Länge beschränkt. Umfangreiche
  Filterausdrücke in GET-Aufrufen sind oft zu lang. Die Verwendung von POST umgeht diese
  Einschränkung.
• Bei der Verwendung von POST werden die Query-Parameter bei der Verwendung
  von HTTPS verschlüsselt übertragen und werden nicht in Request-Logs protokolliert. Dies kann
  aus Sicherheits- oder Datenschutzgründen erwünscht sein.

Bitte beachten Sie, dass diese Funktionalität veraltet ist. Benutzen Sie stattdessen eine Ad-hoc-Query aus Features - Search.

Das Modul ergänzt weiterhin die Unterstützung für den folgenden Query-Parameter:

• intersects: Ist der Parameter angegeben, werden die Features
  zusätzlich nach der als Wert angegeben Geometrie selektiert und es werden nur Features
  zurückgeliefert, deren primäre Geometrie sich mit der angegebenen Geometrie schneidet. Als
  Geometrie kann entweder eine WKT-Geometrie angegeben werden oder eine URL für ein
  GeoJSON-Objekt mit einer Geometrie. Im Fall einer FeatureCollection wird die erste Geometrie
  verwendet.

Operationen

Ressource	Pfad	Methoden	Formate	Beschreibung
Features	collections/{collectionId}/items	POST	CSV, CityJSON, CityJSON-Seq, FlatGeobuf, GML, GeoJSON, HTML, JSON-FG	Der Unterschied zum Aufruf mit GET ist, dass die Query-Parameter als Content im Aufruf übergeben werden.

Pfad-Parameter

Name	Ressourcen	Beschreibung
collectionId	Features, Feature	Der Identifikator der Feature Collection.

Query Parameter

Name	Ressourcen	Beschreibung
intersects	Features	Eine Well-Known-Text-Geometrie gemäß der Definition in Simple Feature Access - Part 1: Common Architecture oder eine URI, die ein GeoJSON-Feature mit einer Geometrie zurückgibt. Es werden nur Features zurückgegeben, die die Geometrie schneiden.

Konfiguration

Optionen

Name	Default	Beschreibung	Typ	Seit
buildingBlock		Immer FEATURES_EXTENSIONS.	string	v2.0
extensionType		Deprecated Siehe buildingBlock.	string	v2.0
enabled	false	Soll das Modul aktiviert werden?	boolean	v2.0
postOnItems	false	Deprecated Benutzen Sie stattdessen eine Ad-hoc-Query aus Features - Search. Aktiviert die Unterstützung für die HTTP-Methode POST auf der Ressource "Features"	boolean	v3.1
intersectsParameter	false	Aktiviert die Unterstützung für den Query-Parameter intersects auf der Ressource "Features"	boolean	v3.1

Beispiele

{@examples}