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)
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):

[ {
  "milestones" : [ ],
  "month" : 12,
  "value" : 0.22999,
  "year" : 2014,
  "day" : 25,
  "hour" : 0
}, {
  "milestones" : [ ],
  "month" : 12,
  "value" : 0.15,
  "year" : 2014,
  "day" : 25,
  "hour" : 1
}...
]

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.

Source Distribution

helen_electricity_usage-0.1.0.tar.gz (3.2 kB view hashes)

Uploaded Source

Built Distributions

helen_electricity_usage-0.1.0-py2.py3-none-any.whl (5.0 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page