https://github.com/netsoft-ruidias/ha-custom-component-precoscombustiveis
Preços dos Combustíveis Online - DGEG
https://github.com/netsoft-ruidias/ha-custom-component-precoscombustiveis
combustiveis dgeg fuel-prices gas hacs hass home-assistant portugal
Last synced: 3 months ago
JSON representation
Preços dos Combustíveis Online - DGEG
- Host: GitHub
- URL: https://github.com/netsoft-ruidias/ha-custom-component-precoscombustiveis
- Owner: netsoft-ruidias
- License: mit
- Created: 2022-06-20T21:08:08.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-10-16T15:10:52.000Z (about 2 years ago)
- Last Synced: 2023-10-17T03:18:24.130Z (about 2 years ago)
- Topics: combustiveis, dgeg, fuel-prices, gas, hacs, hass, home-assistant, portugal
- Language: Python
- Homepage:
- Size: 138 KB
- Stars: 14
- Watchers: 1
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
[](https://github.com/hacs/integration)
# Preços dos Combustíveis - DGEG
Fuel Prices in Portugal - Custom Component for Home Assistant
The data source for this integration is the [DGEG - Direcção-Geral de Energia e Geologia](https://www.dgeg.gov.pt/).
The author of this project categorically rejects any and all responsibility for the fuels prices that were presented by the integration.
# Installation
## HACS (Recommended)
This is an official HACS integration and can be added via HACS.
Assuming you have already installed and configured HACS, follow these steps:
1. Navigate to the HACS integrations page at http://:8123/hacs/integrations.
2. Search for `DGEG - Preços dos Combustíveis` under `Integrations` in the HACS Store tab.
3. Click `Download this Repository with HACS`
4. Your done! Now continue with the configuration.
## Manual
Manual installation is not recomended
# Configuration
## Through the interface
1. Navigate to `Settings > Devices & Services` and then click `Add Integration`
2. Search for `Precos Combustiveis`
3. (Go to [dgeg](https://precoscombustiveis.dgeg.gov.pt/api/PrecoComb/ListarDadosPostos), search for the desired gas station and copy it's `Id`)
4. Enter the StationId you copied in the previous step
5. Repeat the procedure as many times as desired to include other stations
## Through configuration.yaml
Manual configuration through _configuration.yaml_ is not recomended, please use the interface configuration as described above
## Sample
One can use the standard [entities](https://www.home-assistant.io/dashboards/entities/) card to display data in the UI:
```yaml
type: entities
entities:
- entity: sensor.galp_irmaos_peres_lda_souto_gasoleo_simples_2
name: Gasóleo simples
- entity: sensor.galp_irmaos_peres_lda_souto_gasoleo_especial
name: Gasóleo especial
- entity: sensor.galp_irmaos_peres_lda_souto_gasoleo_colorido
name: Gasóleo colorido
- entity: sensor.galp_irmaos_peres_lda_souto_gasolina_especial_95
name: Gasolina especial 95
- entity: sensor.galp_irmaos_peres_lda_souto_gasoleo_simples
name: Gasolina especial 98
- entity: sensor.galp_irmaos_peres_lda_souto_gasolina_simples_95
name: Gasolina simples 95
- type: divider
- entity: sensor.galp_irmaos_peres_lda_souto_gasolina_simples_95
type: attribute
attribute: Name
name: Empresa
icon: mdi:greenhouse
- entity: sensor.galp_irmaos_peres_lda_souto_gasolina_simples_95
type: attribute
attribute: Brand
name: Marca
icon: mdi:widgets
- entity: sensor.galp_irmaos_peres_lda_souto_gasolina_simples_95
type: attribute
attribute: StationType
name: Tipo de Posto
- entity: sensor.galp_irmaos_peres_lda_souto_gasolina_simples_95
type: attribute
attribute: LastPriceUpdate
name: Ultima Actualização de Preço
icon: mdi:reload
title: GALP Irmãos Peres, Lda
```
Which will result in the following card:
Or, if you prefer, you can even use a [custom:auto-entities](https://github.com/thomasloven/lovelace-auto-entities) card to auto display your prices:
```yaml
type: custom:auto-entities
card:
type: entities
title: Diesel Prices
filter:
include:
- entity_id: /sensor\..*_gasoleo/
sort:
method: state
numeric: true
reverse: false
```
Or, use the [custom:bar-card](https://github.com/custom-cards/bar-card) integration to display a nice graph:
```yaml
type: custom:stack-in-card
cards:
- type: custom:mushroom-template-card
primary: Preços Combustíveis
secondary: Gasóleo Aditivado
icon: mdi:gas-station
icon_color: orange
- type: custom:bar-card
entities:
- entity: sensor.galp_garagem_parque_de_barcelos_lda_gasoleo_especial
name: Galp Manhente
color: '#FA551E'
- entity: sensor.galp_garagem_parque_de_barcelos_lda_gasoleo_especial_2
name: Galp Garagem Parque
color: '#FA551E'
- entity: sensor.alves_bandeira_ab_de_tamel_gasoleo_especial
name: Alves Bandeira
color: '#002262'
- entity: >-
sensor.freitas_casp_area_de_servico_portas_do_cavado_lda_gasoleo_especial
name: CASP
color: '#E75938'
- entity: sensor.generico_aparicio_carvalho_araujo_lda_gasoleo_especial
name: Galo Gamil
color: '#E75938'
- entity: sensor.repsol_e_s_barcelos_ii_gasoleo_especial
name: Repsol (escola)
color: '#FF8200'
- entity: sensor.leclerc_e_leclerc_barcelos_gasoleo_especial
name: E Leclerc
color: '#005ABB'
- entity: sensor.bp_bp_barcelos_frescainha_gasoleo_especial
name: BP Vila Frescainha
color: '#00AD5E'
height: 25px
decimal: 3
min: 0.5
max: 2.5
positions:
name: inside
value: inside
icon: outside
indicator: 'off'
minmax: 'off'
style: |
bar-card-name{
margin-right: 10px !important;
font-size: var(--paper-font-body1_-_font-size);
white-space: nowrap;
}
bar-card-background{
margin: 4px 0 4px 0 !important;
}
ha-card{
--bar-card-border-radius: 5px;
}
#states{
padding: 0 16px;
}
#states > * {
margin-bottom: 0px;
}
```
Which will result in the following card:
## Map Card
Since version v1.4.0 you can also add these entities to your map card, to show them in your map
```yaml
type: map
entities:
- entity: zone.home
- entity: zone.other
- entity: person.one
- entity: person.two
- entity: person.three
- entity: sensor.galp_garagem_parque_de_barcelos_lda_gasoleo_especial
name: GALP
- entity: sensor.bp_bp_barcelos_frescainha_gasoleo_especial
name: BP
hours_to_show: 12
default_zoom: 12
dark_mode: true
```
# Legal notice
This is a personal project and isn't in any way affiliated with, sponsored or endorsed by [DGEG](https://www.dgeg.gov.pt/).
All product names, trademarks and registered trademarks in (the images in) this repository, are property of their respective owners. All images in this repository are used by the project for identification purposes only.