The Geo Dashboard of WSO2 CEP is a Jaggery application that provides realtime information about geo spatial objects. It processes spatial data from an external source of events and analyzes/manipulates this data to produce meaningful information to end users using the geo dashboard. You can interact with it to generate a variety of alerts and warnings as follows.
Alert type | Description |
|---|---|
| Speed alert | You can specify a maximum speed limit to all spatial objects. If an object exceeds the specified speed, an alert will be generated. |
| Proximity alert | You can specify a radius and a time. Thereby, a warning will be populated if two spatial objects arrive near each other within the specified limits. |
| Within alert | You can specify a geo area and if any spatial object comes in to the specified area an alert will be generated. |
| Stationery alert | You can specify a geo area and a fluctuation radius and a time, which will generate an alert if any spatial object is located in that area during the specified time. Fluctuation radius is used to minimize the fluctuation effect of a spatial object. |
| Congestion Alert | You can define a geo area. An alert is generated when the congestion level in that area changes. |
You can use the Geo Dashboard of WSO2 CEP as described below.
Prerequisites
Set up the following prerequisites before starting the configurations.
- Install the GPL - Siddhi Geo Extension feature. For detailed instructions to install GPL features, see Installing WSO2 GPL Features.
- Copy the two extension JAR files in the
<CEP_HOME>/samples/cep/utils/geo-dashboard-extensions/directory to the<CEP_HOME>/repository/components/lib/directory.
Running the Geo Dashboard
Navigate to the <CEP_HOME>/repository/resources/geo-dashboard directory and copy all the folders into <CEP_HOME>/repository/deployment/server
Executing the producer
Follow the steps below to run the tfl-feed producer client from the command line.
- Download GeoTools GIS toolkit
- Copy the following client JAR files from downloaded
<GeoTools_HOME>directory to both<CEP_HOME>/repository/components/lib/directory and<CEP_HOME>/samples/cep/libdirectory.gt-geojson-13.1.jargt-main-13.1.jargt-metadata-13.1.jarjai_core-1.1.3.jarjai_imageio-1.1.jar
- Download JTS Topology Suite.
- Copy jts-1.8.jar from
<JTS_HOME>/libdirectory to both<CEP_HOME>/repository/components/libdirectory and<CEP_HOME>/samples/cep/libdirectory. - Navigate to
<CEP_HOME>/samples/cep/producers/tfl-feed/directory, and execute theantcommand in a new tab of your CEP console, to execute the producer of the Geo Dashboard application.
Accessing the Geo Dashboard
Follow the steps below to start and access the Geo Dashboard.
- Start the WSO2 CEP server. For instructions, see Starting CEP.
- Access the Geo Dashboard application in your Web browser using the following URL: https://localhost:9443/portal/dashboards/geo-dashboard
This dashboard can be used to define alerts, define geo fences, click on spatial objects to view information relating to them etc.