Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ojarva/python-helen-electricity-usage
Small library for fetching electricity usage statistics from Helsingin Energia website.
https://github.com/ojarva/python-helen-electricity-usage
electricity home-automation parser scraper
Last synced: 3 months ago
JSON representation
Small library for fetching electricity usage statistics from Helsingin Energia website.
- Host: GitHub
- URL: https://github.com/ojarva/python-helen-electricity-usage
- Owner: ojarva
- License: bsd-3-clause
- Created: 2014-12-27T16:40:49.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2024-03-03T06:06:21.000Z (11 months ago)
- Last Synced: 2024-06-05T04:45:24.444Z (8 months ago)
- Topics: electricity, home-automation, parser, scraper
- Language: Python
- Size: 23.4 KB
- Stars: 9
- Watchers: 3
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.rst
- License: LICENSE.txt
Awesome Lists containing this project
README
Helsingin Energia electricity usage scraper
===========================================
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:
::
from datetime import datetime, timezone
import helen_electricity_usage
helen = helen_electricity_usage.Helen(username, password, delivery_site_id)
helen.login()
begin = datetime(year=2023, month=1, day=1, hour=0, minute=0, second=0, tzinfo=timezone.utc)
end = datetime(year=2023, month=1, day=1, hour=23, minute=59, second=59, tzinfo=timezone.utc)
print(helen.get_electricity(begin, end))
To obtain username and password, register using `web interface
`_ (paper invoice is required).
After registering and signing in, delivery site id is available on the URL of Sähkö/Electricity page as well as on the page
under Käyttöpaikka/Consumption location
::
https://web.omahelen.fi/personal/reports/electricity-consumption?location=&resolution=month&date=2023-01-01
Sample output (python dictionary):
::
{
"intervals": {
"electricity": [
{
"start": "2022-12-24T00:00:00+00:00",
"stop": "2022-12-24T23:59:59+00:00",
"resolution_s": 3600,
"resolution": "hour",
"unit": "kWh",
"measurements": [
{
"value": 0.11,
"status": "valid"
},
{
"value": 0.12,
"status": "valid"
},
{
"value": 0.11,
"status": "valid"
},
{
"value": 0.12,
"status": "valid"
},
{
"value": 0.11,
"status": "valid"
},
{
"value": 0.12,
"status": "valid"
},
{
"value": 0.79,
"status": "valid"
},
{
"value": 0.35,
"status": "valid"
},
{
"value": 0.28,
"status": "valid"
},
{
"value": 0.26,
"status": "valid"
},
{
"value": 0.21,
"status": "valid"
},
{
"value": 0.26,
"status": "valid"
},
{
"value": 1.08,
"status": "valid"
},
{
"value": 1.03,
"status": "valid"
},
{
"value": 0.39,
"status": "valid"
},
{
"value": 0.47,
"status": "valid"
},
{
"value": 3.33,
"status": "valid"
},
{
"value": 3.83,
"status": "valid"
},
{
"value": 1.19,
"status": "valid"
},
{
"value": 0.43,
"status": "valid"
},
{
"value": 0.4,
"status": "valid"
},
{
"value": 0.32,
"status": "valid"
},
{
"value": 0.13,
"status": "valid"
},
{
"value": 0.12,
"status": "valid"
}
]
}
]
}
}
Missing data can be identified from the status being 'invalid' and value is 0.0.
Usually the data is available next day, but that is not guaranteed.