Geo Dashboard

The Geo Dashboard of WSO2 DAS 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 DAS 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 directory <DAS_HOME>/samples/cep/utils/geo-dashboard-extensions/ to the <DAS _HOME> /repository/components/lib/ directory.
Add <Role>GeoDashboard</Role> to /repository/conf/carbon.xml under <ServerRoles> parent tag

Add the following configuration in <DAS_HOME>/repository/conf/datasources/master-datasources.xml file under <datasources> parent element and restart the server.

<datasource>
    <name>WSO2_GEO_DB</name>
    <description>The datasource used for geo dashboard</description>
    <jndiConfig>
        <name>jdbc/WSO2GeoDB</name>
    </jndiConfig>
    <definition type="RDBMS">
        <configuration>
            <url>jdbc:h2:repository/database/WSO2_GEO;DB_CLOSE_ON_EXIT=FALSE;LOCK_TIMEOUT=60000</url>
            <username>wso2carbon</username>
            <password>wso2carbon</password>
            <driverClassName>org.h2.Driver</driverClassName>
            <maxActive>50</maxActive>
            <maxWait>60000</maxWait>
            <testOnBorrow>true</testOnBorrow>
            <validationQuery>SELECT 1</validationQuery>
            <validationInterval>30000</validationInterval>
            <defaultAutoCommit>false</defaultAutoCommit>
        </configuration>
    </definition>
</datasource>

Running the Geo Dashboard

To deploy the required artifacts to run the Geo dashboard, follow the steps below:

Navigate to the <DAS_HOME>/repository/deployment/server directory and check whether it contains the carbonapps directory. If it does not exist, create it.

The carbonapps directory may not be available by default if your DAS installation is a fresh installation.
Copy the org_wso2_carbon_geo_dashboard-1.0.0.car file from the <DAS_HOME>/samples/capp/ directory and place it in the <DAS_HOME>/repository/deployment/server/carbonapps directory.

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 <DAS_HOME>/repository/components/lib/ directory and <DAS_HOME>/samples/cep/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 <DAS_HOME>/repository/components/lib directory and <DAS_HOME>/samples/cep/lib directory.
Navigate to <DAS_HOME>/samples/cep/producers/tfl-feed/ directory, and execute the ant command in a new tab of your DAS 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 DAS server. For instructions, see Running the Product .
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.