General: AstronomyObjectType

Relevant services:

Contents:

NameDescription
name

Object name. Currently, the sun is the only supported astronomical object.

Type: String

Values: sun

event (XML), events (JSON)

Lists all sunrise/sunset events during the day.

Type: Array of AstronomyEventType

special

This element is only present if there are no astronomical events. In this case it will indicate if the sun is up or down the whole day.

Type: AstronomySpecialType

Note: For locations north of the arctic circle, or south of the antarctic circle, the assumptions that there is exactly one sunrise and one sunset event per day, or that the sun will rise before it sets, are not true!

Depending on the date, there may be two sunset events on the same day, or the sun first sets and rises shortly after. For an example, see the sunrise and sunset times for Svalbard during the month of August.