Rise, Transit, Set Times

This end point calculates rising, meridian transit and setting times for the given body and observer location from start to end dates.

Optionally, an observer height above the horizon may be given in meters.

Get the rise, transit and set data for a given body

GEThttps://api.radiantdrift.com/rise-transit-set/{start-date}/{end-date}

Authorization

radianDriftApiKeyradiantDriftJWT

Path parameters

start-date*string

The desired start date/time in Universal Time.

Example: "2018-03-01T07:00:00.000Z"

end-date*string

The desired end date/time in Universal Time.

Example: "2018-03-02T07:00:00.000Z"

Query parameters

Response

2004XX

Body

application/json

query*object

response*object

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://api.radiantdrift.com/rise-transit-set/{start-date}/{end-date}?observer=text&body=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

2004XX

{
  "query": {
    "name": "rise-transit-set",
    "startDate": "2018-03-01T07:00:00.000Z",
    "endDate": "2018-03-02T07:00:00.000Z",
    "observer": {
      "lat": 40.0349,
      "lng": -105.2619,
      "height": 1631
    },
    "body": [
      "sun",
      "moon"
    ],
    "hah": 0,
    "cost": 6
  },
  "response": {
    "2018-03-01T07:00:00.000Z": [
      {
        "key": "sunrise",
        "date": "2018-03-01T13:34:39.221Z",
        "dateTD": "2018-03-01T13:35:48.220Z",
        "jde": 2458179.06653032,
        "eclipticCoordinates": {
          "λ": 340.91385167,
          "β": 0
        },
        "apparentCoordinates": {
          "decl": -7.47232528,
          "ra": -17.61298761
        },
        "apparentLongitude": 340.91385167,
        "radiusVector": 0.99087282,
        "obliquityOfEcliptic": 23.43692915,
        "equatorialHorizontalParallax": 0.00246528,
        "azAlt": {
          "true": {
            "azimuth": 99.1336528,
            "altitude": -0.76135451
          },
          "apparent": {
            "azimuth": 99.1336528,
            "altitude": -0.24443914
          },
          "parallax": {
            "azimuth": 0,
            "altitude": 0.00246166
          },
          "refraction": 0.51691538
        }
      },
      {
        "key": "solar_transit",
        "date": "2018-03-01T19:13:19.434Z",
        "dateTD": "2018-03-01T19:14:28.433Z",
        "jde": 2458179.30171797,
        "eclipticCoordinates": {
          "λ": 341.14990703,
          "β": 0
        },
        "apparentCoordinates": {
          "decl": -7.38279016,
          "ra": -17.39272326
        },
        "apparentLongitude": 341.14990703,
        "radiusVector": 0.99092999,
        "obliquityOfEcliptic": 23.43692907,
        "equatorialHorizontalParallax": 0.00246514,
        "azAlt": {
          "true": {
            "azimuth": 180.00098906,
            "altitude": 42.58049725
          },
          "apparent": {
            "azimuth": 180.00098906,
            "altitude": 42.59618839
          },
          "parallax": {
            "azimuth": 0,
            "altitude": 0.00181259
          },
          "refraction": 0.01569115
        }
      },
      {
        "key": "sunset",
        "date": "2018-03-02T00:52:36.438Z",
        "dateTD": "2018-03-02T00:53:45.437Z",
        "jde": 2458179.53733145,
        "eclipticCoordinates": {
          "λ": 341.38636244,
          "β": 0
        },
        "apparentCoordinates": {
          "decl": -7.29299516,
          "ra": -17.17217509
        },
        "apparentLongitude": 341.38636244,
        "radiusVector": 0.99098742,
        "obliquityOfEcliptic": 23.43692898,
        "equatorialHorizontalParallax": 0.00246499,
        "azAlt": {
          "true": {
            "azimuth": 261.10249469,
            "altitude": -0.76246709
          },
          "apparent": {
            "azimuth": 261.10249469,
            "altitude": -0.2453887
          },
          "parallax": {
            "azimuth": 0,
            "altitude": 0.00246137
          },
          "refraction": 0.51707839
        }
      },
      {
        "key": "moonrise",
        "date": "2018-03-02T00:45:39.680Z",
        "dateTD": "2018-03-02T00:46:48.679Z",
        "jde": 2458179.53250786,
        "eclipticCoordinates": {
          "λ": 161.32864608,
          "β": 2.34147524
        },
        "geocentricSphericalCoordinates": {
          "λ": 161.32864608,
          "β": 2.34147524,
          "Δ": 368023.60398649
        },
        "apparentCoordinates": {
          "ra": 163.67259514,
          "decl": 9.48116269
        },
        "apparentLongitude": 161.325453,
        "obliquityOfEcliptic": 23.43531117,
        "radiusVector": -16976.95601351,
        "nutationInLongitude": -0.00319308,
        "nutationInObliquity": -0.0016181,
        "equatorialHorizontalParallax": 0.9930304,
        "meanElongation": 177.77142441,
        "meanAnomalySun": 56.52621315,
        "meanAnomalyMoon": 55.08412785,
        "argOfLatitude": 23.82620089,
        "azAlt": {
          "true": {
            "azimuth": 77.77733957,
            "altitude": -0.75763163
          },
          "apparent": {
            "azimuth": 77.77733957,
            "altitude": -0.2412617
          },
          "parallax": {
            "azimuth": 0,
            "altitude": 0.9916511
          },
          "refraction": 0.51636993
        }
      },
      {
        "key": "moonset",
        "date": "2018-03-01T13:30:16.175Z",
        "dateTD": "2018-03-01T13:31:25.174Z",
        "jde": 2458179.06348581,
        "eclipticCoordinates": {
          "λ": 154.56252154,
          "β": 1.77214275
        },
        "geocentricSphericalCoordinates": {
          "λ": 154.56252154,
          "β": 1.77214275,
          "Δ": 366597.2658528
        },
        "apparentCoordinates": {
          "ra": 157.07954186,
          "decl": 11.48668477
        },
        "apparentLongitude": 154.5593416,
        "obliquityOfEcliptic": 23.43530406,
        "radiusVector": -18403.2941472,
        "nutationInLongitude": -0.00317994,
        "nutationInObliquity": -0.00162539,
        "equatorialHorizontalParallax": 0.99689442,
        "meanElongation": 172.05369429,
        "meanAnomalySun": 56.06394489,
        "meanAnomalyMoon": 48.95635805,
        "argOfLatitude": 17.62134396,
        "azAlt": {
          "true": {
            "azimuth": 284.88274265,
            "altitude": -0.77371185
          },
          "apparent": {
            "azimuth": 284.88274265,
            "altitude": -0.25498578
          },
          "parallax": {
            "azimuth": 0,
            "altitude": 0.9955106
          },
          "refraction": 0.51872607
        }
      }
    ]
  }
}