helen-electricity-usage 0.5.0

Small library for scraping electricity usage information from Helsingin Energia website

This small script fetches per-hour electricity usage from Helsingin Energia (Helen) website. This is unofficial implementation which may break at any time, if Helen changes their website or implements any additional validations.

Installation:

pip install helen_electricity_usage

Usage:

import helen_electricity_usage
helen = helen_electricity_usage.Helen(username, password, metering_point_number, customer_number)
helen.login()
print helen.get_date("20141225")

To obtain username and password, register using web interface (Flash and paper invoice is required). After registering and signing in, metering point number is available on the top-right corner.

Sample output (python dictionary):

[{'month': 10,
 'hour': 0,
 'year': 2020,
 'waterFlowPrice': 0.0,
 'temperature': 11.8,
 'milestones': [],
 'value': 0.92999,
 'day': 1,
 'teleEuro': 0.0,
 'status': 30,
 'telePrediction': 0.0},
{'month': 10,
 'hour': 1,
 'year': 2020,
 'waterFlowPrice': 0.0,
 'temperature': 11.2,
 'milestones': [],
 'value': 0.66,
 'day': 1,
 'teleEuro': 0.0,
 'status': 30,
 'telePrediction': 0.0},
 ...
]

There is no way to check whether data for specific date is available. If data is not available, all fields are provided, but values are 0.0. There is no way to distinct between missing data and hours with no electricity consumption. Usually the data is available next day, but that is not guaranteed.