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.
|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.
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
samples/utils/geo-dashboard-extensions/directory to the
Running the Geo Dashboard
Follow the steps below to run the Geo Dashboard.
- Navigate to the
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.
- 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
antcommand 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
adminas 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.