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
  1. Body Position

Request Parameters

URL structure and parameters

PreviousBody PositionNextPosition at a given time

Last updated 1 year ago

Requests to the body-position end point are made as follows:

GET https://api.radiantdrift.com/body-position/[DATE_TIME_FROM][/DATE_TIME_TO]/?[body=BODIES|ra-decl=RA_DECL][&obs=OBSERVER][&alg=ALGORITHM][&extras=EXTRAS][&interval=INTERVAL]

Request Parameters

Parameter
Default
Description

DATE_TIME_FROM

none

The desired start date/time in Universal Time, or the desired instant if DATE_TIME_TO is omitted

DATE_TIME_TO

none

The desired end date/time in Universal Time

BODIES

none

A comma-separated list of bodies. Allowed values are sun, moon, gc, where gc denotes the . Required if ra_decl is omitted.

RA_DECL

none

Comma-separated values for right ascension and declination in decimal degrees. Required if bodies is omitted.

OBSERVER

none

Comma-separated values for latitude, longitude (negative west), and elevation above mean sea level in meters; latitude/longitude values are in decimal degrees. Optional - if provided, local horizontal coordinates are included in the response

ALGORITHM

standard

Algorithm used to calculate positions. Allowed values are standard, vsop-87a-tr (truncated , applicable only to the Sun, other bodies always use standard). vsop-87a-tr provides higher accuracy.

EXTRAS

none

Comma-separated list of optional extras to include in response. Allowed values are distance-to-earth or d (Sun and Moon), illuminated-fraction or ill (Moon only), waxing or w (Moon), or all. Either the verbose or abbreviated extra name may be used. Calculating this values may result in a (small) increase in call response time.

INTERVAL

60s

Interval in seconds (optional). When both DATE_TIME_FROM and DATE_TIME_TO are given, the interval determines the interval time in seconds for which positions are calculated. The minimum value is 1s.

Galactic Centre
VSOP87