← Maantiede ja sää

Auringonnousu ja -lasku

GET /geo/sun

Hae auringonnousun, auringonlaskun, aurinkokeskipäivän sekä kansalais-/merenkulku-/tähtitieteellisen hämärän ajat mille tahansa sijainnille ja päivälle. Palauttaa kaikki ajat UTC-aikana. Hyödyllinen valokuvaussovelluksille (kultaisen tunnin suunnittelu), ulkoaktiviteettien aikataulutukseen, älykodin valaistuksen automaatioon, uskonnollisten toimitusten sovelluksille ja aurinkoenergian tuotantoarvioille. Erityisen relevantti pohjoismaisilla alueilla, joissa päivänvalon vaihtelut ovat suuria.

Parametrit

lat pakollinen

Latitude

lon pakollinen

Longitude

date valinnainen

Date

Esimerkkipyynnöt

Peruskäyttö
curl "https://nordapi.ee/api/v1/geo/sun?lat=59.9&lon=10.7"
Sunrise and sunset in Oslo today
curl "https://nordapi.ee/api/v1/geo/sun?lat=59.9&lon=10.7"
Sunrise in Tromso on midsummer
curl "https://nordapi.ee/api/v1/geo/sun?lat=69.65&lon=18.96&date=2026-06-21"
Sunset in Cape Town on a specific date
curl "https://nordapi.ee/api/v1/geo/sun?lat=-33.93&lon=18.42&date=2026-12-25"

Reaaliaikainen vastaus

{
  "data": {
    "astronomical_twilight_begin": "1970-01-01T00:00:01+00:00",
    "astronomical_twilight_end": "1970-01-01T00:00:01+00:00",
    "civil_twilight_begin": "2026-08-12T02:32:44+00:00",
    "civil_twilight_end": "2026-08-12T20:11:46+00:00",
    "day_length": 57532,
    "nautical_twilight_begin": "2026-08-12T01:12:05+00:00",
    "nautical_twilight_end": "2026-08-12T21:32:25+00:00",
    "solar_noon": "2026-08-12T11:22:15+00:00",
    "sunrise": "2026-08-12T03:22:49+00:00",
    "sunset": "2026-08-12T19:21:41+00:00"
  },
  "success": true
}