API
Az oldal minden adata elérhető JSON formában, hitelesítés nélkül. Az adat óránként frissül egy háttérfolyamatban — a végpontok adatbázisból szolgálnak ki, nem hívnak külső API-t, ezért gyorsak.
A mezőnevek angolok, és a mértékegység a nevük végén szerepel (_pct, _deg,
_c, _kmh, _m, _mag, _hours).
Gépi leírás: /openapi.json · interaktív: /docs ·
LLM-eknek: /llms.txt
Végpontok
Egy éjszaka mindene — ez a fő végpont, egy hívásból megvan minden.
curl https://csillag.blackit.hu/api/night?location=budapest-xvi
Mikor menjek ki a héten?
curl "https://csillag.blackit.hu/api/forecast?location=zselic&nights=7"
Hova menjek? — a helyszínek fényszennyezettséggel.
curl https://csillag.blackit.hu/api/locations
Mit nézzek? — mélyég-célpontok magassággal és Hold-távolsággal.
curl https://csillag.blackit.hu/api/targets?location=bukk
Friss-e az adat?
curl https://csillag.blackit.hu/api/status
Választható helyszínek:
budapest-xvi, zselic, hortobagy, bukk.
A date paraméter az éjszaka estéjének dátuma
(a 2026-08-26-os éjszaka 26-a estétől 27-e reggelig tart); elhagyva a következő éjszakát adja.
Ha LLM-nek adod át
A válasz score.penalties tömbje megmondja, miért jó vagy rossz egy éjszaka:
hogy a felhőzet, a holdfény, a fényszennyezés vagy a seeing viszi-e el a pontokat. Ebből egy
nyelvi modell értelmes összefoglalót tud írni anélkül, hogy bármit ki kellene találnia.
"penalties": [
{ "reason": "holdfény", "points": -22.5 },
{ "reason": "seeing", "points": -11.8 },
{ "reason": "fényszennyezés", "points": -8.5 },
{ "reason": "felhőzet", "points": -6.3 }
]
Minden válasz tartalmazza a schema_url mezőt, ami a teljes mezőszótárra mutat —
ha egy mező jelentése kérdéses, az a hiteles forrás.
Mezőszótár — /api/schema
| Mező | Egység | Jelentés |
|---|---|---|
| artificial_brightness_ratio | szoros | A mesterséges égfény hányszorosa a természetesnek. 0 = érintetlen ég, 10 = tízszer világosabb a természetesnél |
| astronomical_dark_end | időpont | A csillagászati sötétség vége hajnalban |
| astronomical_dark_start | időpont | A csillagászati sötétség kezdete (a Nap 18 fokkal a horizont alatt). Innentől érdemes halvány objektumot nézni |
| attribution | — | Az adatforrások megnevezése — a licencek megkövetelik |
| band | NB/BB | NB = keskenysávú szűrő sokat segít (emissziós köd, holdfényben is működik), BB = szélessávú (galaxis, halmaz — holdfényre érzékeny) |
| band_label | — | A sáv magyar megnevezése |
| best_time | időpont | Mikor van a legmagasabban |
| best_window | — | A leghosszabb összefüggő időszak, ahol sötét van és a pontszám 45 felett. null, ha nincs ilyen óra |
| bortle_approx | 1-9 | Bortle-osztály közelítése az SQM-ből. 1 = tökéletesen sötét, 9 = belváros. KÖZELÍTÉS — lásd bortle_note |
| bortle_note | — | Figyelmeztetés a Bortle-érték értelmezéséhez |
| cloud_cover_pct | % | Teljes felhőborítottság. 0 = derült, 100 = teljesen borult |
| cloud_high_pct | % | Magas szintű (fátyol-) felhőzet — a legkevésbé zavaró |
| cloud_low_pct | % | Alacsony szintű felhőzet. Ez a legrosszabb fajta: sűrű, és a városi fényt is visszaveri |
| cloud_mid_pct | % | Közepes szintű felhőzet |
| confidence | — | Az előrejelzés megbízhatósága: "magas" (nagy felbontású modell, 1-3 nap), "közepes" (3-5 nap), "alacsony" (5 napon túl) |
| dark_hours | óra | A csillagászati sötétség hossza. Magyarországon télen 11-12 óra, június közepén viszont csak 1-3 óra |
| dark_hours_scored | darab | Hány sötét órát vett figyelembe a pontszám |
| data | — | Az adat frissességére vonatkozó információk |
| date | dátum | Az éjszaka ESTÉJÉNEK dátuma (YYYY-MM-DD) |
| dew_point_c | °C | Harmatpont |
| dew_risk | — | Harmatkockázat: "alacsony", "közepes" vagy "magas" |
| dew_spread_c | °C | A hőmérséklet és a harmatpont különbsége. 2 fok alatt az optika bepárásodik |
| elevation_m | méter | Tengerszint feletti magasság |
| end | időpont | Az időablak vége |
| gust_kmh | km/h | Széllökés |
| hours | óra | Az időablak hossza |
| humidity_pct | % | Relatív páratartalom |
| jetstream_kmh | km/h | A legerősebb felső légköri szél (200-300 hPa). Ebből becsüljük a seeinget: erős jet-stream = nyugtalan, remegő csillagkép |
| label | — | Az éjszaka megnevezése magyarul |
| label_slug | — | A címke ékezet nélküli alakja (megjelenítéshez) |
| label_text | — | A pontszám magyar címkéje |
| latitude | fok | Földrajzi szélesség (WGS84) |
| longitude | fok | Földrajzi hosszúság (WGS84) |
| magnitude | magnitúdó | Látszó fényesség. Kisebb szám = fényesebb objektum |
| max_altitude_deg | fok | A célpont legnagyobb magassága az éjszaka folyamán. 30 fok alatt a légköri elnyelés miatt nem javasoljuk |
| mean_cloud_pct | % | Átlagos felhőzet a sötét órákban |
| mean_score | 0-100 | Átlagos pontszám az időablakban |
| model_agreement | — | "erős" = a modellek egyetértenek (megbízható), "mérsékelt", "eltérő" = bizonytalan előrejelzés |
| model_spread_pct | % | A modellek felhőzet-becsléseinek szórása |
| models_cloud_pct | % | A felhőzet-becslés modellenként — ebből látszik, mennyire biztos |
| models_used | — | A lekérdezett időjárási modellek |
| moon_altitude_deg | fok | A Hold magassága. Negatív = lement, nem zavar |
| moon_illumination_pct | % | A Hold megvilágított hányada. 0 = újhold, 100 = telihold |
| moon_max_altitude_deg | fok | A Hold legnagyobb magassága az éjszaka folyamán |
| moon_phase_deg | fok | Holdfázis-szög: 0 = újhold, 90 = első negyed, 180 = telihold, 270 = utolsó negyed |
| moon_phase_name | — | A holdfázis magyar neve |
| moon_separation_deg | fok | Szögtávolság a Holdtól. 60 fok alatt a Hold fénye zavar |
| moon_trend | — | "növő" (0-180 fok) vagy "fogyó" (180-360 fok) |
| moon_up | igen/nem | Fent van-e a Hold |
| moonrise | időpont | Holdkelte, vagy null ha ebben az időszakban nincs |
| moonset | időpont | Holdnyugta, vagy null ha ebben az időszakban nincs |
| naked_eye_limit_mag | magnitúdó | A szabad szemmel még látható leghalványabb csillag fényessége. Nagyobb szám = több látszó csillag |
| name | — | A helyszín neve |
| nautical_dark_end | időpont | A nautikus szürkület vége |
| nautical_dark_start | időpont | A nautikus szürkület kezdete (Nap -12 fok) |
| no_astronomical_darkness | igen/nem | Igaz, ha egyáltalán nincs csillagászati sötétség. Magyarországon ez nem fordul elő, csak 48,6 foknál északabbra |
| note | — | Megjegyzés a célpontról |
| penalties | — | Mi mennyi pontot vont le. Ebből derül ki, MIÉRT rossz egy éjszaka: a felhőzet, a holdfény, vagy a fényszennyezés a fő ok |
| points | pont | A levont pontszám (negatív szám) |
| precip_prob_pct | % | Csapadék valószínűsége |
| primary_model | — | Melyik időjárási modellből származik az adat. chmi_aladin = 2,3 km felbontás (legpontosabb, 3 napra), icon_eu = 7 km, ecmwf_ifs = 25 km |
| reason | — | A pontlevonás oka |
| schema_url | — | Erre a mezőszótárra mutató link |
| score | 0-100 | Az adott óra megfigyelési alkalmassága |
| seeing | — | Légköri nyugodtság becslése: "kiváló", "jó", "közepes", "gyenge", "rossz". Nem mért adat, a magaslégköri szelekből számoljuk |
| sky_quality_sqm | mag/arcsec² | Modellezett zenit-égfényesség. Minél NAGYOBB, annál sötétebb az ég. 22,0 a természetes határ, 21,5 felett kiváló, 18 alatt erősen fényszennyezett |
| slug | — | A helyszín rövid azonosítója, ezt kell a `location` paraméterbe tenni |
| stale | igen/nem | Igaz, ha az adat 3 óránál régebbi. Ilyenkor a frissítő job hibázhatott, de a korábbi adatot továbbra is kiszolgáljuk |
| start | időpont | Az időablak kezdete |
| sun_altitude_deg | fok | A Nap magassága. Negatív = a horizont alatt |
| sunrise | időpont | Napkelte másnap reggel |
| sunset | időpont | Napnyugta (helyi idő, ISO-8601 eltolással) |
| targets | — | Javasolt mélyég-célpontok erre az éjszakára |
| temperature_c | °C | Hőmérséklet 2 méteren |
| time | időpont | Az óra kezdete helyi időben |
| timezone | — | Az időbélyegek időzónája |
| twilight | — | A szürkületi fázis neve magyarul |
| twilight_phase | 0-4 | 0 = csillagászati sötét, 1 = csillagászati szürkület, 2 = nautikus, 3 = polgári szürkület, 4 = nappal |
| type | — | A célpont típusa: galaxis, köd vagy halmaz |
| value | 0-100 | Megfigyelési alkalmasság a sötét órák átlagában. 80+ kiváló, 65+ jó, 45+ közepes, 25+ gyenge, alatta alkalmatlan |
| visibility_m | méter | Vízszintes látótávolság |
| weather_age_minutes | perc | Hány perce frissült az adat |
| weather_updated_at | időpont | Mikor frissült utoljára sikeresen az időjárás-adat |
| wind_kmh | km/h | Szélsebesség 10 méteren. 25 felett rázza a távcsövet |
Felhasználási feltételek
Az oldal nonprofit, hobbi célra készült, és az adatforrások licencei ezt meg is követelik:
az Open-Meteo ingyenes szintje és a Falchi-atlasz (CC BY-NC 4.0) egyaránt nem kereskedelmi
használatra szól. Ha az adatot továbbhasznosítod, a forrásmegjelölés kötelező — minden API-válasz
tartalmazza az attribution blokkot.