Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 9 additions & 36 deletions CONFORMANCE.md
Original file line number Diff line number Diff line change
@@ -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

Expand All @@ -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/<cid>/<fid>/<pname>`) — 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.
2 changes: 1 addition & 1 deletion main.go
Original file line number Diff line number Diff line change
Expand Up @@ -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},
Expand Down