Request Parameters

URL structure and parameters

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 Galactic Centre. 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 VSOP87, 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.