# csillag.blackit.hu

Csillagászati megfigyelés-támogató adatszolgáltatás magyar megfigyelőhelyekre.
Megválaszolja, hogy érdemes-e ma éjjel távcsövet ragadni, mikor a legjobb az
időablak, és mit érdemes nézni.

## Hogyan működik

Az adat óránként frissül egy háttérfolyamatban, és adatbázisból szolgáljuk ki.
Az oldal kérés közben soha nem hív külső API-t, ezért gyors és stabil.

Négy fix megfigyelőhely van: Budapest XVI. kerület (városi ég) és a három
magyar csillagoségbolt-park (Zselic, Hortobágy, Bükk).

## Végpontok

- GET /api/locations
  A választható helyszínek, fényszennyezettségi adatokkal.

- GET /api/night?location={slug}&date=YYYY-MM-DD
  A fő végpont. Egy éjszaka mindene: nap- és holdkelte/nyugta, holdfázis
  (százalék és növő/fogyó), a csillagászati sötétség ablaka, óránkénti
  felhőzet három modellből, megfigyelési pontszám, legjobb időablak,
  javasolt célpontok. A date az ESTE dátuma, elhagyható (alapból ma este).

- GET /api/forecast?location={slug}&nights=7
  Éjszakánkénti összefoglaló: mikor érdemes kimenni a héten.

- GET /api/targets?location={slug}&date=YYYY-MM-DD
  Mélyég-célpontok az adott éjszakára, magassággal és Hold-távolsággal.

- GET /api/status
  Mikor frissült az adat, elavult-e.

- GET /api/schema
  Minden mező jelentése, mértékegysége magyarul. Ha egy mező értelmezése
  kérdéses, ez a hiteles forrás.

- GET /openapi.json
  Gépi API-leírás.

## Amit érdemes tudni az értelmezéshez

A pontszám 0-100 skálán mutatja a megfigyelési alkalmasságot. A `penalties`
tömb megmondja, mi rontja el: felhőzet, holdfény, fényszennyezés, seeing,
harmatkockázat, szél vagy csapadék. Ebből meg lehet fogalmazni, hogy MIÉRT
nem jó egy éjszaka, nem csak azt, hogy nem jó.

Magyarországon nyáron nagyon rövid a csillagászati sötétség: június közepén
1-3 óra, decemberben viszont közel 12. A `dark_hours` mező ezt mutatja.

A Bortle-osztály közelítés, a valós vizuális besorolás jellemzően 1-2
osztállyal rosszabb. Az `sky_quality_sqm` a megbízhatóbb szám.

## Adatforrások

Időjárás: Open-Meteo.com (CC BY 4.0)
Fényszennyezettség: Falchi et al. 2016, World Atlas of Artificial Night Sky
  Brightness, GFZ Data Services (CC BY-NC 4.0)
Efemerisz: Skyfield / JPL DE440s