api.radiantdrift.com
  • Radiant Drift API
    • Subscription Plans
    • Educational Use and Research
    • API End Points
  • Getting Started
    • About your account
    • Request Authentication
    • Managing API Keys
    • OpenAPI Specification
    • Date/Time Format
    • Validity, Accuracy, and Precision
  • Usage Guidelines
    • Acceptable Use Policy
    • Usage Credits and Call Costs
    • Attribution
    • Rate Limits
  • Julian Day
  • Delta-T
  • Rise, Transit, Set Times
  • Body Position
    • Request Parameters
    • Position at a given time
    • Positions for a time range
    • Observer location
  • Solar Eclipses
    • Embeddable Web Widgets
      • Eclipse Map
      • Eclipse Simulator
    • Besselian Elements
    • Local Circumstances
    • Eclipse Paths
    • Five Millennium Canon of Solar Eclipses
  • The Moon
    • Lunar Libration
    • Lunar Limb Profile
  • Geospatial
    • Geodesic
    • Elevation
  • Reference
    • Definitions
    • Errors
Powered by GitBook
On this page

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.

PreviousDelta-TNextBody Position

Last updated 10 months ago

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

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

get
Authorizations
Path parameters
start-datestringRequired

The desired start date/time in Universal Time.

Example: 2018-03-01T07:00:00.000Z
end-datestringRequired

The desired end date/time in Universal Time.

Example: 2018-03-02T07:00:00.000Z
Query parameters
observerstringRequired

Comma-separated values for latitude, longitude (negative west), and elevation above mean sea level in meters; latitude/longitude values are in decimal degrees.

Example: 40.0349,-105.2619,1631
bodystringRequired

A comma-separated list of bodies. Allowed values are sun, moon, gc, where gc denotes the Galactic Centre.

Example: sun,moon
hahnumberOptional

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.

Example: 0
Responses
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
        }
      }
    ]
  }
}