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},