Versions Compared

Old Version 23

changes.mady.by.user Former user

Saved on

compared with

New Version 24

changes.mady.by.user Former user

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Location-based services (LBS) uses real-time location or geo-data from devices to monitor and track devices. The geo extension in WSO2 IoT Server provides real-time information about geospatial objects. It processes spatial data from an external source of events and analyzes/manipulates this data to produce meaningful information to end users. You can interact with it to generate a variety of alerts and warnings. 

...

  1. Download the WSO2 IoT Server.

    Tip

    If you are running WSO2 IoT Server already, stop the server before proceeding to the next step.

  2. Navigate to the <IOTS_HOME>/wso2/analytics/scripts folder and run the following command. This installs the required geo extension feature to WSO2 IoT Server.

    Code Block
    mvn clean install -f siddhi-geo-extention-deployer.xml

  3. Open the cdm-config.xml file found in the <IOTS_HOME>/conf folder and set the following properties under the <GeoLocationConfiguration> tag to true. 
    This enables the geo extension feature in WSO2 IoT Server.

    Code Block
    <GeoLocationConfiguration>
      <isEnabled>true</isEnabled>
      <PublishLocationOperationResponse>true</PublishLocationOperationResponse>
</GeoLocationConfiguration>

  4. Start the WSO2 IoT Server core and analytics profiles and sign in to the WSO2 IoT Server Device Management Console.

    Expand
    titleClick here for more information.

    1. Start the WSO2 IoT Server core profile.

      Code Block
      cd <IOTS_HOME>/bin
sh iot-server.sh

    2. Next, start the WSO2 IoT Server analytics profile.

      Code Block
      cd <IOTS_HOME>/bin
sh analytics.sh

    3. Access the device management console.

    4. Enter the username and password, and sign in.

      Info

      The system administrator will be able to log in using admin for both the username and password. However, other users will have to first register with IoTS before being able to log into the IoTS device management console. For more information on creating a new account, see Registering with WSO2 IoT Server.

    5. Click  LOGIN . The respective device management console will change, based on the permissions assigned to the user.
      For example, the device management console for an administrator is as follows:


    Tip
    titleDeploying in a multi-tenant environment

    The geo analytics artifacts are deployed by default in the WSO2 IoT Server super tenant. However, if you are setting up geofencing in a multi-tenant environment, you have to deploy the geo analytics artifacts in each tenant. 

    1. Login to the device management console using the tenant credentials.

    2. Click on the menu button and select Configuration Management>Platform Configurations.

    3. Click the Deploy Geo Analytics Artifacts button. You can also use this button to redeploy the geo analytics artifacts in super tenant mode if required.

  5. Enroll a device. For this tutorial, an Android device has been enrolled. 

    Tip

    For more information on how to enroll an Android device, see Android.

    For more information on how to enroll other sample device types, see Enrolling Sample Devices. 

  6. Access the geofencing map for the device you just enrolled by doing the following:
    1. Click the menu icon, and then click Device Management.
    2. Click view on the device you just enrolled and select the Location tab. 

...

  1. Click on the Add Geofence Exit Alert button. 

  2. Define a geo area.

    Expand
    titleClick to see more information
    Panel
    borderColor#11375B
    bgColor#ffffff
    borderWidth2

    There are two ways to define a geofence area.

    • Draw area - Draw an area on the map to set the boundaries of the geofence.
    • Enter area - Enter a geoJSON containing coordinates to set the boundaries of the geofence. You can import a geofence using this option.
    Draw area
    1. Click Draw Area.
    2. Select a shape (pentagon or square) on the drawing palette found on the left corner of the map.

    3. Select points on the map to draw a pentagon geofence, or click and drag to draw a square or circle geofence.

    4. Enter an appropriate name for the geofence, and click Save.

    Enter area (Import area)
    To enter or import an area using a geoJSON, you have to first draw an area using the map, as shown above, and then export it.

    1. do one of the following actions:

      1. Click Save to save your geofence.

      2. Click Edit to edit the geoJSON that is generated when you draw the geofence.
      3. Click Export to export the geofence and download a geoJSON file. You can use this file to import the same geofence to a different device.
    Enter area (Import area)
    To enter or import an area using a geoJSON, you have to first draw an area using the map, as shown above, and then export it.
    Tip

    Entering an area using a geoJSON is particularly useful when you want to import the exact same geofence for another device or another system. You can draw the geofence in the first device and then copy over the same fence with the exact coordinates to define the same geofence for a different device.

    1. Draw an area using the map, as shown above.
    2. Enter an appropriate name for the geofence and click Export. A geoJSON file will be downloaded on to your machine.
    3. Open the JSON file and copy the JSON code.
    4. Click Enter Area.
      Image Modified
    5. Do one of the following to import the geofence:

      • Click Choose File and select the JSON file you exported in step b. Click Import.

      • Enter the JSON you copied in step c to define the geofence boundary and click Import.The code block below shows a sample JSON.

        Code Block
        {
    "type": "Feature",
    "properties": {},
    "geometry": {
        "type": "Polygon",
        "coordinates": [
            [
                [
                    79.85129186650738,
                    6.910663750244661
                ],
                [
                    79.85129186650738,
                    6.911776767011602
                ],
                [
                    79.85373804112896,
                    6.911776767011602
                ],
                [
                    79.85373804112896,
                    6.910663750244661
                ],
                [
                    79.85129186650738,
                    6.910663750244661
                ]
            ]
        ]
    }
}

Geofence enter alert

A geofence enter alert notifies the user when the device enters the specified geofence area. For example, an employer may set up a geofence enter alert to a room that contains files with highly classified information in them to notify him or prevent certain employees with restricted access from entering the room. 

...

  1. Click on the Add Geofence Enter Alert button. 

  2. Define a geo area.

    Expand
    titleClick to see more information
    To adjust the coordinates or the geofence

    do one of the following actions:

    1. Click Save to save your geofence.

    2. Click Edit to edit the geoJSON that is generated when you draw the geofence.
    3. Click Export to export the geofence and download a geoJSON file. You can use this file to import the same geofence to a different device.
    Enter area (Import area)
    To enter or import an area using a geoJSON, you have to first draw an area using the map, as shown above, and then export it.


    Panel
    borderColor#11375B
    bgColor#ffffff
    borderWidth2

    There are two ways to define a geofence area.

    • Draw area - Draw an area on the map to set the boundaries of the geofence.
    • Enter area - Enter a geoJSON containing coordinates to set the boundaries of the geofence. You can import a geofence using this option.
    Draw area
    1. Click Draw Area.
    2. Select a shape (pentagon or square) on the drawing palette found on the left corner of the map.

    3. Select points on the map to draw a pentagon geofence, or click and drag to draw a square or circle geofence.

    4. Enter an appropriate name for the geofence, and click Save.

    Tip
    Tip

    Entering an area using a geoJSON is particularly useful when you want to import the exact same geofence for another device or another system. You can draw the geofence in the first device and then copy over the same fence with the exact coordinates to define the same geofence for a different device.

    1. Draw an area using the map, as shown above.
    2. Enter an appropriate name for the geofence and click Export. A geoJSON file will be downloaded on to your machine.
    3. Open the JSON file and copy the JSON code.
    4. Click Enter Area.
    5. Do one of the following to import the geofence:

      • Click Choose File and select the JSON file you exported in step b. Click Import.

      • Enter the JSON you copied in step c to define the geofence boundary and click Import.The code block below shows a sample JSON.

        Code Block
        {
    "type": "Feature",
    "properties": {},
    "geometry": {
        "type": "Polygon",
        "coordinates": [
            [
                [
                    79.85129186650738,
                    6.910663750244661
                ],
                [
                    79.85129186650738,
                    6.911776767011602
                ],
                [
                    79.85373804112896,
                    6.911776767011602
                ],
                [
                    79.85373804112896,
                    6.910663750244661
                ],
                [
                    79.85129186650738,
                    6.910663750244661
                ]
            ]
        ]
    }
}

Stationary alert

Stationary alerts notify the users about the state changes of a device in a predefined geo area. If a device remains stationed within the predefined geo area for a predefined period of time, an alert is generated. For example, you can use this alert to track a lost phone that you may have left in a taxi cab or a public bus. When the device stops moving, you can identify the taxi/bus location and retrieve your phone. 

  1. Click on the Add Stationary Alert button. 

  2. Define a geo area.

    Expand
    titleClick to see more information
    Panel
    borderColor#11375B
    bgColor#ffffff
    borderWidth2

    There are two ways to define a geofence area.

    • Draw area - Draw an area on the map to set the boundaries of the geofence.
    • Enter area - Enter a geoJSON containing coordinates to set the boundaries of the geofence. You can also import a geofence using this option.
    Draw area
    1. Click Draw Area.
    2. Select a shape (pentagon, square, or circle) on the drawing palette found on the left corner of the map.

    3. Select points on the map to draw a pentagon geo-fence, or click and drag to draw a square or circle geofence.

      Image Modified

    4. Enter the following details and click Save.details:

      1. Fence name - Enter an appropriate name for the geo area.
      2. Fluctuation radius - Specify a radius. The fluctuation radius is used to minimize the fluctuation effect of the device.
      3. Time - The device should be stationary for the number of seconds specified in this field to generate a pop-up alert.

    5. Do one of the following actions:

      1. Click Save to save your geofence.

      2. Click Edit to edit the geoJSON that is generated when you draw the geofence.
      3. Click Export to export the geofence and download a geoJSON file. You can use this file to import the same geofence to a different device.
    Enter area (Import area)
    To enter or import an area using a geoJSON, you have to first draw an area using the map, as shown above, and then export it.
    Tip

    Entering an area using a geoJSON is particularly useful when you want to import the exact same geofence for another device or another system. You can draw the geofence in the first device and then copy over the same fence with the exact coordinates to define the same geofence for a different device.

    1. Draw an area using the map as shown above.
    2. Enter an appropriate name for the geofence and click Export. A geoJSON file will be downloaded on to your machine.
    3. Open the JSON file and copy the JSON code.
    4. Click Enter Area.
      Image Modified
    5. Do one of the following to import the geofence:

      • Click Choose File and select the JSON file you exported in step b. Click Import.

      • Enter the JSON you copied in step c to define the geofence boundary and click Import.The code block below shows a sample JSON.

        Code Block
        {
    "type": "Feature",
    "properties": {},
    "geometry": {
        "type": "Polygon",
        "coordinates": [
            [
                [
                    79.85129186650738,
                    6.910663750244661
                ],
                [
                    79.85129186650738,
                    6.911776767011602
                ],
                [
                    79.85373804112896,
                    6.911776767011602
                ],
                [
                    79.85373804112896,
                    6.910663750244661
                ],
                [
                    79.85129186650738,
                    6.910663750244661
                ]
            ]
        ]
    }
}

Speed alert

Speed alerts notify users when a device is traveling above the predefined speed limit. This alert does not require a geofence and is applied globally (wherever the device is located). For example, a system administrator for a taxi service may use this to monitor whether any of the taxi drivers are driving above the allowed speed limit. 

...