AstronomyAPI
v2
Search
⌃K

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

Rendering different views

Constellation

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
}
}
}

Area

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
}
}
}

Styles

default

inverted

red