FinEstSmartMobility API - Alpha

This page describes the Alpha-version of the FinEst API, which is a pilot project within the FinEstSmartMobility project and gives you programmatic access to the ferry schedules and real-time monitoring of ferry locations and schedule accuracy. The API is designed to be used by SmartMobility solutions and also offers a way to study the statistical data of the ferry traffic between Helsinki West Harbour and Tallinn Old City Harbour. The API uses fully and freely accessible public Open Data.

Statistics

Basic statistics of the API as per 14 Aug 2018 shows:

  1. That we have collected around 6 million data points during 130 days of operations
  2. That we have tracked succesfully 1536 voyages
  3. That on an average the ferries are very well on time and seem to depart 8.4 minutes ahead of schedule
  4. Arrival accuracy is stellar and on an average the ferries arrive only 48 seconds (!) behind schedule


Schedule accuracy medians

Looking at the collected data and the median values of schedule accuracy, we note a small tendency towards change in August. It will be interesting to see how this develops during the end of this year and when weather conditions start to play a factor.

How it works

The API is built as a Node.js server application and it fetches data from various publicly available Open Data sources (ship AIS-data, schedules, ship parameters, historical tracks and weather observations). It then analyses the ship sailing parameters and derives the schedule tracking information. The end product is a set of json-format APIs, which are documented using Swagger UI.


You find the Swagger UI API description here.

How to obtain an API key?

In order to use the API, you will need an API key. Please send us a message on finest [ät] fleetrange.com and we will be happy to provide you with a key.

The Tracking API data is updated once per minute and you should not call it more often than this (since there is no new data anyway). The Weather observation data from Helsinki Majakka and the Gulf of Finland wave buoy is provide by FMI under the CC BY 4.0 license and can be accessed for the last 7 days.

Please note that we will be logging the usage of each key for statistical purposes as we are interested to know how much the API will be utilised.

How to access the historical data?

You can access the historical tracking data via the /tracking/voyage/{imo}/{datetime} API. If you are interested of a database dump of all tracking data, please let us know on our email (finest [ät] fleetrange.com) and we will be happy to send you one.

We are currently NOT storing the weather observations, and you will need to create your own storage solution if you like to log the weather information.

License and disclaimer

See this page for license and disclaimer information.


This work relates to call for Tender: H104-17 / HEL 2017-009942 - Helsinki West Harbour and Tallinn Old City Harbour inbound traffic innovation partnership, service procurement

EU CB FinEst