48 tuntia maksutta, 120 tuntia Private Prolla

Mihin tämä on tarkoitettu?

Päätepiste toimittaa vain aikasarjat. Latauspäätös jää evcc:lle. evcc voi sitten ottaa arvot huomioon esimerkiksi lataussuunnittelijassa edullista tai CO2-optimoitua latausta varten. Myös optimoija voi käyttää ennustetietoja, mutta se on evcc:ssä vielä kokeellinen.

Kun julkaistut day-ahead-hinnat ovat saatavilla, päätepiste käyttää niitä ensin. Sen jälkeisille tunneille mukaan tulee ennusteemme. Tästä on hyötyä etenkin, kun haluat suunnitella latausajankohtia usealle päivälle.

Pika-aloitus: lisää evcc:hen

Uutta: tuntihinnat evcc:lle. Laskuttaako sähköyhtiösi yhtenäisen hinnan tuntia kohden? Käytä silloin HTTP-hintalähdettämme parametrilla resolution=hourly. Tuntitariffien määritykseen.

Lohko kuuluu tiedostoon evcc.yaml YAML:n ylimmälle tasolle, eli ei kohtien loadpoints, chargers, meters tai yksittäisten laitteiden alle. Jos sinulla on jo lohko tariffs:, älä luo sitä toiseen kertaan, vaan täydennä tai korvaa sen rivit.

tariffs:
  currency: EUR
  grid:
    type: custom
    forecast:
      source: http
      uri: https://api.energypriceforecast.eu/api/v1/evcc/tariff?country=fi&type=grid&hours=48

  co2:
    type: custom
    forecast:
      source: http
      uri: https://api.energypriceforecast.eu/api/v1/evcc/tariff?country=fi&type=co2&hours=120

Käynnistä sen jälkeen evcc uudelleen. Komennolla evcc tariff voit tarkistaa, lataako evcc arvot oikein. Jos haluat testata vain hintaennustetta, aluksi riittää osa grid:.

Hintaennusteen lisääminen evcc:hen

Esimerkki: Suomi. Arvot ovat yksikössä EUR/kWh.

tariffs:
  currency: EUR
  grid:
    type: custom
    forecast:
      source: http
      uri: https://api.energypriceforecast.eu/api/v1/evcc/tariff?country=fi&type=grid&hours=48

hours=48 käyttää maksutonta hintajaksoa. 1. lokakuuta 2026 alkaen päätepiste palauttaa ilman API-avainta enintään 48 tuntia; nykyiset anonyymit 120 tunnin määritykset toimivat edelleen ja lyhennetään 48 tuntiin.

Tuntitariffi: sopivat hinnat suunnittelijalle

Jos sähköyhtiölläsi on yhtenäinen hinta jokaiselle täydelle tunnille, lisää hintalähteemme HTTP-osoitteeseen tämä: &resolution=hourly. API laskee neljän julkaistun pörssivartin keskiarvon yhdeksi tuntihinnaksi. Sen jälkeinen malliennuste pysyy tuntikohtaisena.

forecast:
  source: http
  uri: https://api.energypriceforecast.eu/api/v1/evcc/tariff?country=fi&type=grid&hours=48&resolution=hourly

Lohko on ote nykyisestä lähteestäsi. Jos käytät tietojamme suunnittelijassa erikseen, muuta vain tätä lähdettä ja säilytä sähköyhtiösi tariffi kustannuksia ja tilastoja varten. Nykyinen hintakaava ja API-avaimen asetukset säilyvät. API toimittaa edelleen perushintoja; lisien ja verojen on vastattava sopimustasi.

Myös käynnissä olevan tunnin aikana tuntitila ottaa huomioon kaikki neljä varttia. Jos arvo puuttuu, se käyttää täyttä tuntikohtaista day-ahead-korvausarvoa tai tuntikohtaista malliennustetta. Pelkkien jäljellä olevien varttien keskiarvoa ei palauteta tuntihintana.

Varttihinnoitellussa sopimuksessa jätä osoite ennalleen tai käytä parametria resolution=native. Julkaistut pörssihinnat pysyvät silloin varttikohtaisina; myöhemmät ennustearvot pysyvät tuntikohtaisina.

Sisäänrakennettu evcc-malli energypriceforecast tarjoaa lisäasetuksissa valinnan average: true. Omat lähteet, joiden tyyppi on custom, tukevat asetusta features: [average]. Käynnissä olevan tunnin täyteen keskiarvoon suosittelemme HTTP-lähdettä parametrilla resolution=hourly; erillistä keskiarvon laskentaa evcc:ssä ei silloin tarvita. evcc-viite

Enintään 120 tuntia API-avaimella

Lisää henkilökohtainen API-avaimesi Bearer-tunnisteena suoraan HTTP-lohkoon ja aseta hours=120. Avain kuuluu kohtaan forecast.auth, ei osoitteeseen.

tariffs:
  currency: EUR
  grid:
    type: custom
    forecast:
      source: http
      uri: https://api.energypriceforecast.eu/api/v1/evcc/tariff?country=fi&type=grid&hours=120
      auth:
        type: bearer
        token: "OMA_API_AVAIMESI"

Käynnistä sen jälkeen evcc uudelleen ja suorita evcc tariff tarkistukseksi. Älä jaa API-avainta julkisesti äläkä julkaise sitä foorumiviesteissä tai lokeissa.

CO2-ennusteen lisääminen evcc:hen

Esimerkki: Suomi. Arvot ovat yksikössä g/kWh.

tariffs:
  co2:
    type: custom
    forecast:
      source: http
      uri: https://api.energypriceforecast.eu/api/v1/evcc/tariff?country=fi&type=co2&hours=120

CO2-arvot ovat ennusteita. Ne auttavat ajoituksessa ja kuvaavat arvioitua CO2e-kuormaa kulutettua kilowattituntia kohden, mutta eivät korvaa virallista päästötasetta.

Tuetut maat ja hinta-alueet

Testaa selaimessa

Parametrilla debug=1 saat lisäksi metatietoja lähteestä. evcc-määrityksessä parametria debug=1 ei pidä käyttää.

Hyvä tietää

Lue lisää