diff --git a/README.md b/README.md index 660e2e9..2603ab9 100644 --- a/README.md +++ b/README.md @@ -14,9 +14,9 @@ _Integration to integrate with [pyfuelprices][pyfuelprices]._ **This integration will set up the following platforms.** -| Platform | Description | -| ---------------- | ---------------------------------------------------------------------------- | -| `device_tracker` | Optional entities for fuel stations, attributes will contain fuel price data | +| Platform | Description | +| -------- | ---------------------------------------------------------------------------- | +| `sensor` | Optional entities for fuel stations, attributes will contain fuel price data | ## Installation @@ -32,9 +32,15 @@ _Integration to integrate with [pyfuelprices][pyfuelprices]._ This integration relies entirely on cloud services, alongside this a few libraries are used to geocode provided coordinates into location data for certain providers such as GasBuddy or TankerKoenig. -For reverse geocoding a mix of Nominatim (https://nominatim.org/), these-united-states (https://pypi.org/project/these-united-states/) and reverse-geocode (https://pypi.org/project/reverse-geocode/). This is done to improve performance, for example, looking up provided coordinates with reverse-geocode will allow us to restrict the fuel station search to data providers available in only that country. +For reverse geocoding a mix of Nominatim (https://nominatim.org/) and these-united-states (https://pypi.org/project/these-united-states/). This is done to improve performance, for example, looking up provided coordinates with Nominatim will allow us to restrict the fuel station search to data providers available in only that country. -Similar to this, this integration will use these-united-states to retrieve the state of given coordinates, and finally Nominatim is used to retrieve the nearest postcode for the TankerKoenig data source. +Similar to this, this integration will use these-united-states to retrieve the state of given coordinates, and finally Nominatim is also used to retrieve the nearest postcode for the TankerKoenig data source. + +## Configuration + +A new configuration parameter was introduced in 2024.6.0 that allows you to specify what state to display within Home Assistant. By default this is name, however it can be changed to a value of your liking after setup by clicking `Configure` followed by `Configure data collection sources`. This parameter is called `State to show on the created sensors`. + +This value must be set to a fuel price key (available under `Available Fuels` for the produced sensor entities). In the UK this can be reliably set to E5 or B7, however if you set to SDV, a large number of fuel stations either do not stock this or do not provide this data. In this case the integration will default back to the fuel station name but this may create warnings / errors in your logs. Currently this cannot be configured by area. ## Configuration is done in the UI