API.EWS.03 Fetch Alert
OGC API Features Adoption
To ensure interoperability with existing geospatial systems and standards, DCI EWS standard adopts the OGC API Features standard as the primary mechanism for querying early warning alerts.
Within this specification, alerts are represented as an OGC API Features collection. Implementations expose an alerts collection (for example, GET /collections/alerts) where each feature corresponds to a single alert. The feature geometry represents the spatial extent of the alert, while the feature properties contain the complete CAP Alert object, preserving all alert information defined by the Common Alerting Protocol (CAP).
This approach enables clients to leverage the standard OGC API Features capabilities for discovery, retrieval, and filtering without introducing custom API patterns. Consumers can retrieve all alerts from the collection or query specific alerts using standard OGC API Features query parameters.
Filtering is performed against the feature properties, which contain the embedded CAP Alert object. This allows clients to search alerts using CAP attributes such as:
Alert identifier
Sender
Status
Message type
Scope
Event type
Severity
Urgency
Certainty
Effective and expiry times
Any other standardized CAP field exposed within the feature properties
By adopting OGC API Features, the specification remains fully compatible with the broader OGC ecosystem while preserving the complete CAP information model, enabling both geospatial and semantic queries through a standardized, interoperable API.
Some usage Examples
Last updated
Was this helpful?