How to Record and Access Past Road Closure Incidents in Historical Data

Symptoms / Triggers

You need to query or analyze road closure incidents from a past time period.
The default HERE real-time stream only keeps data for a short time (e.g., 10 minutes or 7 days).
You lack a permanent record of road closure data beyond the volatile retention periods.

Quick Answer To record and access past road closure incidents, you must archive data from the RTTI stream (e.g., traffic-incidents-delta-stream) using an index layer, filter the data for road closures, and query it based on time and location.

---

Step-by-step Actions
--------------------

1. Subscribe to the RTTI Incident Stream

Subscribe to the traffic-incidents-delta-stream using the catalog HRN:

hrn:here:data::olp-here:here-traffic-incidents-v2

This stream has a short retention period (TTL of about 10 minutes).

1. Create an Index Layer

Use HERE Workspace to create an index layer that will store the archived incident data.
Design your index with relevant attributes such as event_time, incident_type, location, country, TMC_code, and tile_id.

1. Build an Archiving Application

Develop and run an application (as a pipeline) to read from the stream layer and archive the data into the index layer.
Use the Data Archiving Library in Java to parse and index streaming incident data.
Filter the incident stream for road closure-type incidents after deserialization.
Ensure you include metadata such as tile IDs and location references (e.g., SupplementaryLocationReference).

1. Index and Archive Incidents

Use the getKeys() function in your application to define how data is indexed (e.g., by event time, location, or incident type).
Archive the messages into the index layer for later querying.

1. Query the Archive for Specific Time Periods

Use the Data API, Data Client Library, or OLP CLI to query your index layer.
Use filters such as event_time, incident_type = road closure, and country/TMC_code to retrieve archived road closure data.
The Index API will return the data handles to the desired records, and the Blob API will retrieve the full incident data.

1. Verify Archiving and Querying Process

Confirm that your pipeline is active and running in the HERE platform portal.
Test your queries on historical data to verify that road closure incidents are accessible as expected.

---

Applies To
----------

HERE Real-Time Traffic Incident (RTTI) data stream
HERE Workspace
Applications requiring access to past road closures or incidents
Organizations needing long-term historical road traffic data storage and querying

---

Tags
----

road closure, archiving, historical incidents, HERE traffic data, RTTI, index layer, stream retention, traffic event storage