Astronomy Service

This service offers times for rise, set, noon and twilight times for sun and moon for all locations worldwide on any date.

Locations can be queried by:

  • Location id (obtained by Places Service).
  • Geographical coordinates.

A single query can return results for up to 10 locations, including sun and moon data for up to 31 days.

The service provides the following data:

  • Sunrise, sunset and twilight times and azimuth.
  • Moonrise and moonset times and azimuth.
  • Moon phase and illuminated fraction.
  • Meridian (noon) passing time, altitude and distance.
  • Antimeridian passing time (midnight).

Sample Data

{
  "version": 1,
  "locations": [{
    "id": "152",
    "geo": {
      "name": "Melbourne",
      "state": "Victoria",
      "country": {
        "id": "au",
        "name": "Australia"
      },
      "latitude": -37.814,
      "longitude": 144.963
    },
    "astronomy": {
      "objects": [{
        "name": "sun",
        "days": [{
          "date": "2012-03-19",
          "events": [{
            "type": "antimeridian",
            "utctime": "2012-03-18T14:28",
            "isotime": "2012-03-19T01:28+11:00",
            "hour": 1,
            "min": 28
          },{
            "type": "twi18_start",
            "utctime": "2012-03-18T18:54",
            "isotime": "2012-03-19T05:54+11:00",
            "hour": 5,
            "min": 54
          },{
            "type": "twi12_start",
            "utctime": "2012-03-18T19:25",
            "isotime": "2012-03-19T06:25+11:00",
            "hour": 6,
            "min": 25
          },{
            "type": "twi6_start",
            "utctime": "2012-03-18T19:56",
            "isotime": "2012-03-19T06:56+11:00",
            "hour": 6,
            "min": 56
          },{
            "type": "rise",
            "utctime": "2012-03-18T20:22",
            "isotime": "2012-03-19T07:22+11:00",
            "hour": 7,
            "min": 22,
            "azimuth": 91.3
          },{
            "type": "meridian",
            "utctime": "2012-03-19T02:28",
            "isotime": "2012-03-19T13:28+11:00",
            "hour": 13,
            "min": 28,
            "altitude": 52.6,
            "distance": 148942000
          },{
            "type": "set",
            "utctime": "2012-03-19T08:33",
            "isotime": "2012-03-19T19:33+11:00",
            "hour": 19,
            "min": 33,
            "azimuth": 268.9
          },{
            "type": "twi6_end",
            "utctime": "2012-03-19T08:59",
            "isotime": "2012-03-19T19:59+11:00",
            "hour": 19,
            "min": 59
          },{
            "type": "twi12_end",
            "utctime": "2012-03-19T09:30",
            "isotime": "2012-03-19T20:30+11:00",
            "hour": 20,
            "min": 30
          },{
            "type": "twi18_end",
            "utctime": "2012-03-19T10:01",
            "isotime": "2012-03-19T21:01+11:00",
            "hour": 21,
            "min": 1
          }],
          "daylength": "12:11"
        },{
          "date": "2012-03-20",
          "events": [{
            "type": "antimeridian",
            "utctime": "2012-03-19T14:28",
            "isotime": "2012-03-20T01:28+11:00",
            "hour": 1,
            "min": 28
          },{
            "type": "twi18_start",
            "utctime": "2012-03-19T18:55",
            "isotime": "2012-03-20T05:55+11:00",
            "hour": 5,
            "min": 55
          },{
            "type": "twi12_start",
            "utctime": "2012-03-19T19:26",
            "isotime": "2012-03-20T06:26+11:00",
            "hour": 6,
            "min": 26
          },{
            "type": "twi6_start",
            "utctime": "2012-03-19T19:57",
            "isotime": "2012-03-20T06:57+11:00",
            "hour": 6,
            "min": 57
          },{
            "type": "rise",
            "utctime": "2012-03-19T20:23",
            "isotime": "2012-03-20T07:23+11:00",
            "hour": 7,
            "min": 23,
            "azimuth": 90.8
          },{
            "type": "meridian",
            "utctime": "2012-03-20T02:28",
            "isotime": "2012-03-20T13:28+11:00",
            "hour": 13,
            "min": 28,
            "altitude": 52.2,
            "distance": 148984000
          },{
            "type": "set",
            "utctime": "2012-03-20T08:32",
            "isotime": "2012-03-20T19:32+11:00",
            "hour": 19,
            "min": 32,
            "azimuth": 269.4
          },{
            "type": "twi6_end",
            "utctime": "2012-03-20T08:58",
            "isotime": "2012-03-20T19:58+11:00",
            "hour": 19,
            "min": 58
          },{
            "type": "twi12_end",
            "utctime": "2012-03-20T09:28",
            "isotime": "2012-03-20T20:28+11:00",
            "hour": 20,
            "min": 28
          },{
            "type": "twi18_end",
            "utctime": "2012-03-20T09:59",
            "isotime": "2012-03-20T20:59+11:00",
            "hour": 20,
            "min": 59
          }],
          "daylength": "12:08"
        }]
      }]
    }
  }]
}
<?xml version="1.0" encoding="UTF-8"?>
<data version="1">
  <location id="152">
    <geo>
      <name>Melbourne</name>
      <state>Victoria</state>
      <country id="au">Australia</country>
      <latitude>-37.814</latitude>
      <longitude>144.963</longitude>
    </geo>
    <astronomy>
      <object name="sun">
        <day date="2012-03-19" daylength="12:11">
          <event type="antimeridian" utctime="2012-03-18T14:28" isotime="2012-03-19T01:28+11:00" hour="1" min="28"/>
          <event type="twi18_start" utctime="2012-03-18T18:54" isotime="2012-03-19T05:54+11:00" hour="5" min="54"/>
          <event type="twi12_start" utctime="2012-03-18T19:25" isotime="2012-03-19T06:25+11:00" hour="6" min="25"/>
          <event type="twi6_start" utctime="2012-03-18T19:56" isotime="2012-03-19T06:56+11:00" hour="6" min="56"/>
          <event type="rise" utctime="2012-03-18T20:22" isotime="2012-03-19T07:22+11:00" hour="7" min="22" azimuth="91.3"/>
          <event type="meridian" utctime="2012-03-19T02:28" isotime="2012-03-19T13:28+11:00" hour="13" min="28" altitude="52.6" distance="148942000"/>
          <event type="set" utctime="2012-03-19T08:33" isotime="2012-03-19T19:33+11:00" hour="19" min="33" azimuth="268.9"/>
          <event type="twi6_end" utctime="2012-03-19T08:59" isotime="2012-03-19T19:59+11:00" hour="19" min="59"/>
          <event type="twi12_end" utctime="2012-03-19T09:30" isotime="2012-03-19T20:30+11:00" hour="20" min="30"/>
          <event type="twi18_end" utctime="2012-03-19T10:01" isotime="2012-03-19T21:01+11:00" hour="21" min="1"/>
        </day>
        <day date="2012-03-20" daylength="12:08">
          <event type="antimeridian" utctime="2012-03-19T14:28" isotime="2012-03-20T01:28+11:00" hour="1" min="28"/>
          <event type="twi18_start" utctime="2012-03-19T18:55" isotime="2012-03-20T05:55+11:00" hour="5" min="55"/>
          <event type="twi12_start" utctime="2012-03-19T19:26" isotime="2012-03-20T06:26+11:00" hour="6" min="26"/>
          <event type="twi6_start" utctime="2012-03-19T19:57" isotime="2012-03-20T06:57+11:00" hour="6" min="57"/>
          <event type="rise" utctime="2012-03-19T20:23" isotime="2012-03-20T07:23+11:00" hour="7" min="23" azimuth="90.8"/>
          <event type="meridian" utctime="2012-03-20T02:28" isotime="2012-03-20T13:28+11:00" hour="13" min="28" altitude="52.2" distance="148984000"/>
          <event type="set" utctime="2012-03-20T08:32" isotime="2012-03-20T19:32+11:00" hour="19" min="32" azimuth="269.4"/>
          <event type="twi6_end" utctime="2012-03-20T08:58" isotime="2012-03-20T19:58+11:00" hour="19" min="58"/>
          <event type="twi12_end" utctime="2012-03-20T09:28" isotime="2012-03-20T20:28+11:00" hour="20" min="28"/>
          <event type="twi18_end" utctime="2012-03-20T09:59" isotime="2012-03-20T20:59+11:00" hour="20" min="59"/>
        </day>
      </object>
    </astronomy>
  </location>
</data>

Related Links

Terms & ConditionsCopyright © Time and Date AS
All data supplied by timeanddate.com