FUI StoreConnect Sensor API's server injector

Simple utility tool to inject data to a FUI StoreConnect Sensors API server

Requirements

Have a Java SE Runtime Environment 1.8+ installed.

How to use it

1. Download it

   $ wget -O storeconnect-sensors-api-server-injector.jar https://repo.maven.apache.org/maven2/com/github/storeconnect/storeconnect-sensors-api-server-injector/0.6/storeconnect-sensors-api-server-injector-0.6-jar-with-dependencies.jar

2. Execute it

   $ java -jar storeconnect-sensors-api-server-injector.jar \
       --enpoint <FUI STORECONNECT SENSORS API SERVER BASE URL>/SensorThingsService/1.0 \
       --input <INPUT FILE URL> \
       --data-format <DATA FORMAT>
   

Where:

• <FUI STORECONNECT SENSORS API SERVER BASE URL> is the base URL of the StoreConnect Sensors API Server
• <INPUT FILE URL> is the URL of the input file that containing data to inject
• <DATA FORMAT> is the format of data to use to parse the <INPUT FILE> (see below for the list of available data formats)

Available data formats

The -f or --data-format is used to precise the format of the data to inject to the StoreConnect Sensor API's server.

Hereafter the list of available formats.

flat-motion

When using the flat-motion format, input file has to follow the StoreConnect's flat motion observation format.

An example of the StoreConnect's flat motion observation format is given bellow:

[
    {
        "appuserid": "Cam1_T3_6",
        "building": 1,
        "devicedate": 1512042846315,
        "floor": 0,
        "lat": 50.633479927598877,
        "lon": 3.0241943673786045,
        "type": "location",
        "venueid": "95"
    },
    {
        "appuserid": "Cam1_T3_6",
        "building": 1,
        "devicedate": 1512042846460,
        "floor": 0,
        "lat": 50.63347967549938,
        "lon": 3.0241948411172297,
        "type": "location",
        "venueid": "95"
    },
    {
        "appuserid": "Cam1_T3_6",
        "building": 1,
        "devicedate": 1512042846605,
        "floor": 0,
        "lat": 50.633478499035071,
        "lon": 3.0241970518974806,
        "type": "location",
        "venueid": "95"
    }
]

How to contribute

Feel free to contribute by making a pull request following the contributing instructions.

License

Copyright 2018 Inria Lille

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.