AstronomyAPI
Search…
πŸͺ
Body Properties
Plants, Sun and Moon entities respond with common object properties. This page describes what to expect in the response.
Body entities returned from the API consists of the following properties.
Section
Subsection
Data Type
Description
id
-
string
Unique identifier for the body
name
-
string
User friendly name for the body
distance
-
object
Distance object
-
fromEarth
object
Distance from Earth in Kilometers (km) and Astronomical units (au)
position
-
object
Position object
-
horizonal
object
Position object in horizontal coordinates. Object will return the values in Altitude and Azimuth (Alt/Az) format. Numerical and literal values are returned.
-
equatorial
object
Position object in equatorial coordinates. Object will return the values in Right Ascension and Declination (RA/Dec) format. Numerical and literal values are returned.
extraInfo
-
object
Other information relating to the body
-
elongation
string
Angular separation between the Sun and the planet, with Earth as the reference point
-
magnitude
string
Apparent magnitude of the object
​
phase
object
Phase of the body as an angle and a fraction.
phase property is available only in the Moon body

Sample response object

{
"date": "2017-12-20T08:00:00.000Z",
"id": "saturn",
"name": "Saturn",
"distance": {
"fromEarth": {
"au": "11.04833",
"km": "1652807114.58763"
}
},
"position": {
"horizonal": {
"altitude": {
"degrees": "-57.37",
"string": "-58° 37' 48\""
},
"azimuth": {
"degrees": "78.82",
"string": "78° 49' 12\""
}
},
"equatorial": {
"rightAscension": {
"hours": "17.98",
"string": "17h 58m 48s"
},
"declination": {
"degrees": "-22.53",
"string": "-23° 28' 12\""
}
}
},
"extraInfo": {
"elongation": "1.66392",
"magnitude": "0.31200"
}
}
Copy link
Edit on GitHub