Toevoegen cql aan leermodule

[JLSchaap]

Deze pull request voegt een nieuwe leermodule toe over CQL2-filtering binnen OGC API Features, gebaseerd op de BAG OGC API.

De module introduceert de belangrijkste concepten rondom filtering, waaronder:

Queryables
CQL2 Text syntax
Attribuutfiltering
Combineren van filters met AND, OR en NOT
Tekstfilters met LIKE en IN
Ruimtelijke filtering met bbox
Spatial operators zoals S_INTERSECTS, S_WITHIN en S_CONTAINS
Conformance classes en het bepalen welke filterfunctionaliteit een API ondersteunt
Praktijkvoorbeelden gebaseerd op de BAG OGC API Woonplaats-collectie
Oefeningen met uitklapbare antwoorden
Motivatie

Filtering is een belangrijke functionaliteit binnen OGC API Features en wordt in de praktijk veel gebruikt om datasets efficiënt te bevragen. Hoewel de leermodule reeds aandacht besteedt aan OGC API Features, ontbrak een praktische introductie op CQL2 en spatial filtering.

Met deze toevoeging leren gebruikers:

hoe zij filterbare attributen kunnen ontdekken via Queryables;
hoe zij CQL2-expressies opstellen;
hoe zij ruimtelijke relaties kunnen beschrijven met spatial operators;
hoe zij via het conformance-endpoint kunnen bepalen welke filterfunctionaliteit een OGC API ondersteunt.
Toegevoegde inhoud
Nieuwe uitleg over Queryables
Introductie CQL2 Filtering
Introductie Spatial Filtering
Overzicht van veelgebruikte CQL-operatoren
Gebruik van de BAG Woonplaats-collectie als praktijkvoorbeeld
Uitleg van relevante conformance classes:
filter
features-filter
queryables
cql2-text
basic-cql2
advanced-comparison-operators
spatial-functions
Visualisaties van spatial relaties:
S_INTERSECTS
S_DISJOINT
S_TOUCHES
S_WITHIN
S_CONTAINS
S_OVERLAPS
S_CROSSES
S_EQUALS
Oefeningen inclusief uitklapbare antwoorden (??? success "Antwoord")
Bronmateriaal

Voorbeelden zijn gebaseerd op:

BAG OGC API v2 preprod
collectie woonplaats
/queryables
/conformance
Resultaat

Na het doorlopen van de nieuwe module kan een cursist zelfstandig:

Queryables interpreteren;
eenvoudige en geavanceerde CQL2-filters schrijven;
spatial operators toepassen;
attributaire en ruimtelijke filters combineren;
conformance classes gebruiken om API-capabilities te ontdekken.

Dit sluit beter aan op de huidige mogelijkheden van OGC API Features Part 3 (Filtering) en de implementatie binnen de BAG OGC API.