Skip to content

spusuf/qld_fuel-hass

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Queensland Fuel Price integration for Home Assistant

This integration is for users in Queensland, Australia and gives you sensors for the fuel stations in a (or multiple) areas and some statistics for your Home Assistant dashboards. It utilises the Queensland Government Mandatory Fuel Price Reporting Scheme's API (mouthful, I know)

Setup

  1. You will need to request a Data Consumer Token from this form: Publisher and Data Consumer Sign Up
  2. Install this integration via HACS Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.
  3. Add the integration in home assistant

Features

  • Automatically creates an entry for each station within a selectable radius from your home's location (will add location selector to allow second instance scanning near work, etc)
  • Allows you to select multiple fuel types you want added to home assistant
  • Tracks the price for those fuel types (duh)
  • Tracks the cheapest price in your defined area
  • Tracks the cheapest price in Queensland
  • Tracks statistics in attributes (7 & 14 day lows & averages)
  • Configurable update interval

3 fuel sensors on a dashboard

Each sensor has the following attributes:

  • Difference (in cents) to cheapest in QLD
  • Difference (in cents) to cheapest in your defined area
  • 7 day low price
  • Difference between 7 day low and current
  • 7 day average
  • 14 day low price
  • Difference between 14 day low and current
  • 14 day average
  • Distance (in case you want to do a price delta vs distance graph)

Preview of a sensor with its attributes

Note

The scheme is documented here: Fuel Prices Queensland The API is documented here: API documentation Sorry about the washed out screenshots, HDR on Hyprland is not yet perfect.

To do

Add a location selector to the configuration page to allow second instance in a different location Get non-washed out screenshots with longer term statistics

About

Queensland mandatory fuel price reporting scheme API integration for Home Assistant

Topics

Resources

Stars

Watchers

Forks

Languages