Skip to main content

Small library for scraping electricity usage information from Helsingin Energia website

Project description

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Built Distribution

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page