From d6482b24ad5afbcfea9f8792027ea2b04446feb8 Mon Sep 17 00:00:00 2001 From: Esteban Zimanyi Date: Thu, 19 Nov 2026 15:33:08 +0100 Subject: [PATCH] Keep CONFORMANCE.md the requirement table the Part 4 rows are held to CONFORMANCE.md keyed each requirement of the class cquery to its code and test, and also stated the aggregations, the lifecycle, the delivery and the extensions. What the service answers is stated by the MobilityDB specification doc/specs/mobilityapi-ogc-api.md, so the file keeps the table ats_part4_test.go reads and points to the specification for the rest. --- CONFORMANCE.md | 45 +++++++++------------------------------------ main.go | 2 +- 2 files changed, 10 insertions(+), 37 deletions(-) diff --git a/CONFORMANCE.md b/CONFORMANCE.md index b434472..ec0e1a2 100644 --- a/CONFORMANCE.md +++ b/CONFORMANCE.md @@ -1,11 +1,14 @@ -# OGC API – Moving Features – Part 4 (Stream Extension) — conformance +# OGC API – Moving Features – Part 4 (Stream Extension) — requirements -This tier implements the **Continuous Query** requirements class of OGC API – -Moving Features – Part 4. The class is declared at `GET /conformance`: +The requirements of the **Continuous Query** class of OGC API – Moving Features – +Part 4, `http://www.opengis.net/spec/ogcapi-movingfeatures-4/1.0/conf/cquery`, +keyed by the number and identifier of the draft this service implements, each with +the code that meets it and the test that reads it. `ats_part4_test.go` holds the +suite to this table. -``` -http://www.opengis.net/spec/ogcapi-movingfeatures-4/1.0/conf/cquery -``` +What the service declares and answers under Part 4 and every other standard it +implements is stated by the specification [MobilityAPI and the OGC API +Standards](https://github.com/MobilityDB/MobilityDB/blob/master/doc/specs/mobilityapi-ogc-api.md). ## Requirements @@ -16,33 +19,3 @@ http://www.opengis.net/spec/ogcapi-movingfeatures-4/1.0/conf/cquery | **Req 3** `window_tumbling` — fixed-duration, non-overlapping windows | **met** | `runAggregate` TUMBLING (`stream_engine_meos.go`); `TestMeosTumblingWindow` | | **Req 4** `window_hopping` — fixed-duration, overlapping windows | **met** | `runHopping` (`stream_engine_meos.go`); `TestMeosHoppingWindow` | | **Req 5** `window_count` — windows over a record count | **met** | `runAggregate` COUNT (`stream_engine_meos.go`); `TestMeosWindowAggregate` | - -## Aggregations - -`TemporalProperty` — **met** for all scalar types, computed through MEOS: - -- `TReal` / `TInt`: `COUNT, SUM, AVG, MIN, MAX` (`temporal_num_instants`, - `tfloat_min_value`/`tfloat_max_value`, `tnumber_avg_value`, value sum). -- `TText`: `COUNT, COUNT_DISTINCT` (`ttext_values`). -- `TBoolean`: `COUNT, ANY, ALL, COUNT_TRUE, COUNT_FALSE` (`tbool_values`). - -The `TemporalPrimitiveGeometry` operations of Table 7 (`LENGTH, AREA, TO_TRAJ, …`) -are **not yet** exposed. - -## Lifecycle and delivery - -- Lifecycle states `running`, `stopped`, `failed` are reported by the `cquery` - `status` (`registered` is transient — a query enters `running` on submission). -- Results are delivered over **Server-Sent Events**, one of the channel bindings - Part 4 allows; the Kafka and WebSocket result bindings are not yet exposed. -- Live ingestion: a query with `"live": true` sources pushed records. Producers - push over HTTP (`…/ingest`) or **MQTT** (`MFAPI_MQTT_BROKER`, topic - `mfapi///`) — the EDR Pub/Sub source over a real broker. A - Kafka source feeds the same hub the same way. - -## Extensions beyond Part 4 - -Lifted scalar transforms over a streaming `tfloat` (`ln`, `exp`, `×`, `+`, …), a -geometry position stream (`…/tgsequence/queries`) for an animated map, and the -Flink streaming engine behind the same `StreamEngine` seam are additions, not -Part 4 requirements. diff --git a/main.go b/main.go index e4245c3..732d594 100644 --- a/main.go +++ b/main.go @@ -262,7 +262,7 @@ func routeTable() []route { // Live ingestion: a producer pushes records the live queries process. {"POST", "/collections/{cid}/items/{fid}/tproperties/{pname}/ingest", ingestProperty, extension}, // A continuous query streaming the moving feature's position, the feed of - // an animated map, which CONFORMANCE.md states is no Part 4 requirement. + // an animated map, which no requirement of Part 4 states. {"POST", "/collections/{cid}/items/{fid}/tgsequence/queries", postGeometryQuery, extension}, {"GET", "/collections/{cid}/items/{fid}/tgsequence/queries", listGeometryQueries, extension}, {"GET", "/collections/{cid}/items/{fid}/tgsequence/queries/{qid}", getQuery, extension},