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.
Authorizations
Path parameters
start-datestringRequiredExample:
The desired start date/time in Universal Time.
2018-03-01T07:00:00.000Zend-datestringRequiredExample:
The desired end date/time in Universal Time.
2018-03-02T07:00:00.000ZQuery parameters
observerstringRequiredExample:
Comma-separated values for latitude, longitude (negative west), and elevation above mean sea level in meters; latitude/longitude values are in decimal degrees.
40.0349,-105.2619,1631bodystringRequiredExample:
A comma-separated list of bodies. Allowed values are sun, moon, gc, where gc denotes the Galactic Centre.
sun,moonhahnumberOptionalExample:
Observers height above horizon in meters - NOT the same as observer's elevation above sea level. Set this only when the observer is elevated above the surrounding terrain when the rise or set will be observed. For example, sunrise from a mountain summit looking out over a plane: if the summit is 4000m and the plane lies at 1500m, then hah=2500.
0Responses
200Success
application/json
4XX
Not Found
application/json
get
GET /rise-transit-set/{start-date}/{end-date} HTTP/1.1
Host: api.radiantdrift.com
Accept: */*
{
"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
}
}
]
}
}Last updated