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
Mit fotóztam eddig? — a galéria felvételei a technikával és azzal az éggel, ami alatt készültek.
curl https://csillag.blackit.hu/api/gallery
Választható helyszínek:
budapest-xvi, budapest-ii, balatonalmadi, 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 |
|---|---|---|
| alt_deg | fok | Magasság a horizont felett |
| altitude_curve | — | Magasság és azimut 15 percenként a sötét ablakban: [{time, alt_deg, az_deg}] |
| 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 |
| az_deg | fok | Azimut: 0 = észak, 90 = kelet, 180 = dél, 270 = nyugat |
| azimuth_deg | fok | Irányszög: 0 = észak, 90 = kelet, 180 = dél, 270 = nyugat |
| bad_layers | darab | Zavaró (turbulens) rétegek száma a légkörben: inverziók és instabil rétegződés. Ezek határán keveredik a különböző sűrűségű levegő, ami elmossa a képet. 0 = tiszta rétegződés |
| 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 BECSLÉSE az SQM-ből. 1 = tökéletesen sötét, 9 = belváros. A Bortle-skála vizuális, nem mérhető; a megfeleltetés ±1 osztályt eltérhet — lásd bortle_note |
| bortle_note | — | Figyelmeztetés a Bortle-érték értelmezéséhez |
| caldwell | — | Caldwell-szám (pl. C20), ha van |
| catalog | — | A teljes katalógus (OpenNGC-szűkítés, ~700 objektum) a szűrők szerint, magasság-görbével. Az ablak a nautikus szürkülettől szürkületig tart |
| catalog_id | — | OpenNGC-azonosító (pl. NGC0224, IC1396, Mel022) — a /terkep `cel` paramétere |
| catalog_size | darab | A teljes katalógus mérete |
| 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 |
| common_name | — | Köznapi név az OpenNGC-ből (angol), ha van |
| 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) |
| curated | igen/nem | Szerepel-e a 30 kézzel válogatott célpont között (magyar név, megjegyzés) |
| 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) |
| detail | — | Az ok rövid számszerű magyarázata |
| 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 |
| direction | — | Az irány magyarul (merre nézz) |
| distance_au | CSE | Távolság csillagászati egységben (1 CSE = Nap-Föld távolság) |
| elevation_m | méter | Tengerszint feletti magasság |
| end | időpont | Az ablak vége |
| filters | — | A kérésben érvényesített szűrők (az alapértékekkel kiegészítve) |
| fov_fit | — | Illeszkedés a látómezőbe (fov_x × fov_y): "belefér", "szűken" (80% felett), "mozaik" (legfeljebb 2×), "túl nagy", "apró" (3′ alatt), "ismeretlen" |
| fov_x | ívperc | Szűrő: a látómező hosszú éle (alap 77 — Seestar S50) |
| fov_y | ívperc | Szűrő: a látómező rövid éle (alap 44) |
| gallery_slugs | — | A tulajdonos publikált galéria-bejegyzései erről az objektumról (/galeria/{slug}) — üres, ha még nincs róla fotó |
| gust_kmh | km/h | Széllökés |
| hours | óra | Az időablak hossza |
| hours_in_window | óra | Ennyi ideig van a szűrő ablakában (magasság ÉS azimut) a sötét idő alatt |
| humidity_pct | % | Relatív páratartalom |
| in_window_from | időpont | Mikortól van az ablakban |
| in_window_until | időpont | Meddig van az ablakban |
| integration_min | perc | Becsült szükséges integráció rövid kockás (Seestar-jellegű) fotózáshoz, a felületi fényesség és a helyi ég különbségéből; keskenysávú célpontnál 1,5-szeres |
| inversion_height_m | méter | A legalsó hőmérsékleti inverzió magassága, ha van. Az inverzió tetején jellemzően turbulens a levegő |
| 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) |
| limit | darab | Legfeljebb ennyi találat (0 = nincs korlát) |
| longitude | fok | Földrajzi hosszúság (WGS84) |
| mag_band | V/B | A magnitúdó sávja: V = vizuális, B = kék (ha csak az ismert) |
| magnitude | magnitúdó | Látszó fényesség. Kisebb szám = fényesebb objektum |
| matches | darab | A szűrőknek megfelelő találatok száma a limit előtt |
| max_alt | fok | Szűrő: maximális magasság (alap 90) |
| 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 |
| max_az | fok | Szűrő: azimut-tartomány vége (alap 360); átfordulhat északon, pl. 300–60 |
| max_mag | magnitúdó | Szűrő: legnagyobb magnitúdó, vagy null = nincs korlát |
| max_shear_kmh_km | km/h per km | A legnagyobb szélnyírás a légoszlopban — mennyivel változik a szélsebesség kilométerenként. 30 felett erős turbulencia |
| mean_cloud_pct | % | Átlagos felhőzet a sötét órákban |
| mean_score | 0-100 | Átlagos pontszám az időablakban |
| messier | — | Messier-szám (pl. M31), ha van |
| min_alt | fok | Szűrő: minimális magasság (alap 30) |
| min_az | fok | Szűrő: azimut-tartomány kezdete (alap 0) |
| min_hours | óra | Szűrő: legalább ennyi óra az ablakban (alap 1) |
| minutes | perc | Az ablak hossza |
| 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 |
| planets | — | Az éjszaka látható bolygói, magasság szerint rangsorolva |
| 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 |
| reasons | — | Mi vitt le a target_score-ból: {reason, points, detail} — negatív pontok |
| sb_label | — | Az sb_vs_sky_mag szöveges értelmezése |
| sb_vs_sky_mag | magnitúdó | surface_brightness − sky_quality_sqm: mennyivel halványabb az objektum felülete a helyi égnél. 0 alatt könnyű, 0–2 sok integráció, 2 felett halvány ez alatt az ég alatt |
| 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 |
| seeing_arcsec | ívmásodperc | A seeing BECSÜLT értéke: mennyire mosódik el egy csillag képe. 1" kiváló, 2" jó, 3-4" közepes, 5" felett rossz. Közelítés a magaslégköri szélből és a rétegződésből — nem mérés |
| seeing_cause | — | Mi rontja leginkább a seeinget: jet stream, zavaró rétegek vagy szélnyírás. null, ha nyugodt a légkör |
| simbad_url | — | Az objektum SIMBAD-adatlapja (CDS) — az OpenNGC forrásadata is innen van |
| size_maj_arcmin | ívperc | A látszó méret nagytengelye |
| size_min_arcmin | ívperc | A látszó méret kistengelye |
| sky_quality_source | — | Honnan van az sky_quality_sqm: mért (forrással) vagy modellezett |
| 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 |
| sky_quality_sqm_model | mag/arcsec² | A Falchi-atlaszból modellezett zenit-égfényesség. Ha van mért érték, az sky_quality_sqm attól eltérhet — a modell a sötét helyeken ~0,3-del optimistább |
| slug | — | A helyszín rövid azonosítója, ezt kell a `location` paraméterbe tenni |
| sort | — | Rendezés: max_alt | hours | mag | size |
| 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 ablak kezdete |
| step_minutes | perc | A görbe mintavételi lépése |
| sun_altitude_deg | fok | A Nap magassága. Negatív = a horizont alatt |
| sun_separation_deg | fok | Szögtávolság a Naptól. 15 fok alatt a bolygó a szürkületbe vész, 30 fok alatt csak alacsonyan, szürkületben látszik |
| sunrise | időpont | Napkelte másnap reggel |
| sunset | időpont | Napnyugta (helyi idő, ISO-8601 eltolással) |
| surface_brightness | mag/arcsec² | Felületi fényesség a magnitúdóból és az ellipszis-területből. Csak kiterjedt objektumra (galaxis, köd, planetáris); halmazra nincs, ott félrevezető lenne |
| target | — | A galéria-bejegyzés célpontjának neve (szabad szöveg) |
| target_score | 0-100 | A célpont pontszáma erre az éjszakára: jut-e rá elég jó idő a hajnal vagy a felhő előtt (40), magasság a használható ablakban (20), az ég minősége az ablakban (20), távcső-illeszkedés (15), holdfény (levonás), látványosság (bónusz). BECSLÉS |
| targets | — | A célpont-ajánló: a fotogén katalógus (Messier/Caldwell/válogatott, vagy 10 magnitúdónál fényesebb, ≥ 3′) legjobb 8 eleme target_score szerint |
| targets_fov | — | Az ajánló látómezője ívpercben (fov_x, fov_y) |
| 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. A `targets` listában csoport (galaxis, köd, halmaz); a `catalog` listában OpenNGC-típuskód (G, GPair, GTrpl, GGroup, OCl, GCl, Cl+N, PN, EmN, RfN, SNR, HII, Neb) — a magyar címke a type_label |
| type_label | — | A típus magyarul |
| types | — | Szűrő: OpenNGC-típuskódok listája, vagy null = mind |
| until_dawn | igen/nem | Igaz, ha a szürkületig az ablakban marad |
| usable_minutes | perc | Az ablak felhőzettel súlyozott hasznos ideje |
| 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 | — | Megfigyelhetőség szövegesen: "jól megfigyelhető", "alacsonyan, párás horizont felett", "csak szürkületben" vagy "a Nap közelében" |
| visibility_m | méter | Vízszintes látótávolság |
| weather_age_minutes | perc | Hány perce frissült az adat |
| weather_known | igen/nem | Volt-e időjárás-előrejelzés az ablakra (7 napon túl nincs) |
| 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 |
| window | — | A tervező sötét ablaka: start, end, step_minutes, catalog_size, matches |
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.