NextBreak

Avoin data

Koulujen lomat kehittäjille

Kaikki NextBreakin koulukalenterit JSON-, CSV- ja iCal-muodossa, vapaasti käytettävissä lähde mainiten. Matkailusivustot, koulusovellukset, älykodit ja tutkijat ovat tervetulleita.

JSON- ja CSV-rajapinta

Ei avainta eikä rekisteröitymistä. Vastaukset ovat välimuistissa muutaman tunnin; pysyttele noin kahdessa pyynnössä sekunnissa.

GET https://nextbreak.app/api/v1/calendars              # every calendar (?format=csv)
GET https://nextbreak.app/api/v1/calendars/DE-BY        # one calendar (?year=2026/27, ?format=csv)
GET https://nextbreak.app/api/v1/off?date=2027-02-15    # every calendar off on a date
curl -s https://nextbreak.app/api/v1/calendars/FR-ZC | jq '.breaks[] | {name, start, end}'

Jokaisella lomalla on englanninkielinen ja paikallinen nimi, tyyppi (autumn, christmas, winter, spring, may, summer, other), ensimmäinen ja viimeinen päivä (end on null, jos viranomainen ei ole vielä julkaissut sitä), lukuvuosi sekä virallinen lähde, josta tieto on tarkistettu.

Kalenterisyötteet (iCal)

Jokaisella kalenterilla on syöte, joka päivittyy itsestään, kun viranomainen muuttaa päivämäärää. Osoite löytyy kunkin kalenterin sivulta kohdasta ”Lisää kaikki lomat kalenteriisi”.

https://nextbreak.app/ical/germany-bavaria.ics
https://nextbreak.app/ical/latvia.ics

Home Assistant

Käytä kalenterisyötettä, niin koulupäivien herätykset ja lämmitysaikataulut kytkeytyvät pois loma-aikoina.

  1. Avaa Home Assistantissa Asetukset → Laitteet ja palvelut → Lisää integraatio → Remote calendar.
  2. Liitä kalenterisi iCal-osoite (esimerkiksi yllä oleva Baijerin osoite) ja anna sille nimi.
  3. Käytä uutta kalenterientiteettiä automaatioissa: se on päällä koululoman aikana.
# automations.yaml: no school run on school holidays
- alias: "School morning alarm"
  trigger: { platform: time, at: "06:45:00" }
  condition:
    - condition: state
      entity_id: calendar.school_holidays_bavaria
      state: "off"
  action: { service: script.school_morning }

Lisenssi

Data julkaistaan CC BY 4.0 -lisenssillä: käytä sitä missä tahansa projektissa, myös kaupallisessa, ja mainitse lähteeksi ”NextBreak (nextbreak.app)” linkin kera.

Päivämäärät tulevat opetusviranomaisilta; koulut voivat lisätä muutaman oman vapaapäivän. Tarkista lähde ennen kuin suunnittelet mitään, mitä ei voi siirtää.

Lähteet ja kattavuus →