aishub-collector

AIShub collector gets data from AIShub network and stores it to the MySQL database for later use. The script is written in Python 3.

The collector contains three scripts:

• aishub-collector.py gets current data from AIShub API (see [http://www.aishub.net/api]) and stores it to temp table. You should call this script as often as you wish to get a snapshot of vessels in your area.
• aishub-downsampler.py 1) reads the temp table, 2) writes the last entry of every ship to aisdata and cleans the temp table.
• aishub-stations.py Reads the station network (Station ID, name, uptime and location) from AIShub network website. There is no API for retrieving station data.

Requirements

• Python 3
• pymysql (Debian/Ubuntu package python3-pymysql)
• numpy (Debian/Ubuntu package python3-numpy)

Install

1. Create and edit settings.json based on sample settings.sample.json. You need to fill your AIShub username to the AIShub URL and enter your MySQL credentials.
2. Create MySQL database, e.g.: mysql -u root -p <database.sql
3. Set cron to execute aishub-collector.py every ~2 minutes and aishub-downsampler.py as often as you wish to store the data (e.g. every 24 hours).
4. Set cron to execute aishub-stations.py (e.g. weekly).
5. Profit!