✨
Star Chart
Generates a star chart with the given parameters, and returns the url
If you're looking to quickly integrate this feature on your website without making API calls, checkout Widgets
post
https://api.astronomyapi.com
/api/v2/studio/star-chart
Generate star chart
Parameters
Header
Authorization*
string
Basic <hash>
Body
style
string
Style of the map to be generated. If not provided will use the default style. To see a demo of available styles see styles section on this page.
observer*
object
Observer object must contain the
latitude
, longitude
and date
of the observer.view*
object
View object is used to configure the view of the rendered image. The view object must contain a
type
and parameters
object. Parameters object can vary based on the type
.Responses
200: OK
To generate an image of a constellation the
type
in the view
object must be set to constellation
. The 3 letter ID of the constellation must be passed in the parameters for the view object. For a complete list of constellation IDs see The 3 letter constellation ID is case sensitive, only lower case is allowed
{
"style": "inverted",
"observer": {
"latitude": 33.775867,
"longitude": -84.39733,
"date": "2019-12-20"
},
"view": {
"type": "constellation",
"parameters": {
"constellation": "ori" // 3 letter constellation id
}
}
}
To generate an image of an area in the sky, set the
type
to area
, then pass the RA and Dec values in the position
object for the view parameters
. Currently equatorial coordinates are supported by the API. Additionally the parameter zoom
can be provided to scale the image, but it's optional.// Note how this request does not have the field `style`
// The API will use the default style
{
"observer": {
"latitude": 33.775867,
"longitude": -84.39733,
"date": "2019-12-20"
},
"view": {
"type": "area",
"parameters": {
"position": {
"equatorial": {
"rightAscension": 14.83,
"declination": -15.23
}
},
"zoom": 3 //optional
}
}
}




Last modified 2mo ago