{: .note } This service is currently in beta, but no large changes are expected before going into production.
Data format
Properties
| Body | Name | Description |
|---|---|---|
| Sun | sunrise | when the upper limb of the sun becomes visible over the horizon¹ |
| Sun | sunset | when the upper limb of the sun no longer is visible over the horizon¹ |
| Sun | solarnoon | when the moon centre crosses the meridian |
| Sun | solarmidnight | when the moon centre crosses the antimeridian |
| Moon | moonrise | when the upper limb of the moon becomes visible over the horizon² |
| Moon | moonset | when the upper limb of the moon no longer is visible over the horizon² |
| Moon | high_moon | when the moon centre crosses the meridian |
| Moon | low_moon | when the moon centre crosses the antimeridian |
| - | azimuth | horizontal angle from north to the horizontal component of the disc centre angle from the horizon |
| Moon | phase | degrees, 0 being new moon and 180 being full moon |
Note 1: Technically defined as when the sun is 0.8333 degrees below the horizon. This is an approximation given the average apparent radius of the sun and average refraction (both which can vary slightly due to irregular planetary orbits and atmospheric conditions).
Note 2: Computation of moonrise/set is more complicated than for the sun, as the apparent size of the moon varies since the orbit is not perfectly circular. For simplicity we have chosen a constant value of 34 arcminutes (0.5666 degrees) for atmospheric refraction and an averaged moon radius of 16 arcminutes (0.2667 degrees). For more information, see the US Naval Observatory.
Moon phases
| Degrees | Descripton |
|---|---|
| 0 | New moon |
| 0..90 | Waxing crescent |
| 90..180 | Waxing gibbous |
| 180 | Full moon |
| 180..270 | Waning gibbous |
| 270..360 | Waning crescent |
Example outputs
Sun
{
"type" : "Feature",
"copyright" : "MET Norway",
"licenseURL" : "https://api.met.no/license_data.html",
"geometry" : {
"coordinates" : [
10.716667,
59.933333
],
"type" : "Point"
},
"when" : {
"interval" : [
"2022-12-17T23:17:00Z",
"2022-12-18T23:17:00Z"
]
},
"properties" : {
"body" : "Sun",
"solarmidnight" : {
"disc_centre_elevation" : -53.47,
"time" : "2022-12-19T00:13+01:00",
"visible" : false
},
"solarnoon" : {
"disc_centre_elevation" : 6.67,
"time" : "2022-12-18T12:13+01:00",
"visible" : true
},
"sunrise" : {
"azimuth" : 140.12,
"time" : "2022-12-18T09:16+01:00"
},
"sunset" : {
"azimuth" : 219.87,
"time" : "2022-12-18T15:10+01:00"
}
}
}
Moon
{
"copyright": "MET Norway",
"licenseURL": "https://api.met.no/license_data.html",
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
10.716667,
59.933333
]
},
"when": {
"interval": [
"2022-12-17T23:17:00Z",
"2022-12-18T23:17:00Z"
]
},
"properties": {
"body": "Moon",
"moonrise": {
"time": "2022-12-18T02:01+01:00",
"azimuth": 98.49
},
"moonset": {
"time": "2022-12-18T13:01+01:00",
"azimuth": 255.99
},
"high_moon": {
"time": "2022-12-18T07:41+01:00",
"disc_centre_elevation": 23.89,
"visible": true
},
"low_moon": {
"time": "2022-12-18T20:03+01:00",
"disc_centre_elevation": -39.17,
"visible": false
},
"moonphase": {
"value": 288.54
}
}
}