Geo Dashboard

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/utils/geo-dashboard-extensions/ directory to the <CEP_HOME>/repository/components/lib/ directory.

Running the Geo Dashboard

Follow the steps below to run the Geo Dashboard.

Navigate to the <CEP_HOME>/samples/utils/output-websocket-local-adapter/ directory using the CLI.
Execute the following command, to run the Geo Dashboard application: ant -Dsn 1001

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 <GeoTools_HOME>/ directory to both <CEP_HOME>/repository/components/lib/ directory and <CEP_HOME>/samples/lib/ directory.
- gt-geojson-13.1.jar
- gt-main-13.1.jar
- gt-metadata-13.1.jar
- jai_core-1.1.3.jar
- jai_imageio-1.1.jar
Download JTS Topology Suite.
Copy jts-1.8.jar from <JTS_HOME>/lib directory to both <CEP_HOME>/repository/components/lib/ directory and <CEP_HOME>/samples/lib/ directory.
Navigate to <CEP_HOME>/samples/producers/tfl-feed/ directory, and execute the ant command 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 with the sample configuration numbered 1001. For instructions, see Starting sample CEP configurations.
Access the Geo Dashboard application in your Web browser using the following URL: http://localhost:9763/geo_dashboard/
Log in to the Geo Dashboard application using admin as both the username and the password. Alerts are displayed as shown in the screenshot below.

This dashboard can be used to define alerts, define geo fences, click on spatial objects to view information relating to them etc.