AstronomyAPI
  • 🚀Getting Started
  • API v2 Reference
    • 🪐Bodies
      • 🌐Positions
      • 🗓️Events
    • 📸Studio
      • ✨Star Chart
      • 🌒Moon Phase
    • 🔎Search
  • 🤝Requests and Responses
    • 🪐Body Properties
    • 🕚Event Properties
    • 🔎Search Result Properties
    • 🔭Observer Parameters
    • 🗓️Tabular Responses
    • 🔢Rows Responses
    • 🚩Error Responses
    • 🔢Constellation Enums
    • 🔢DSO Enums
  • Page
  • 🧩Widgets
  • ⚠️Known Issues
  • 📕Changelog
  • Links
    • demo.astronomyapi.com
    • Sample code on Github
    • Back to Dashboard
Powered by GitBook
On this page
  • Generate star chart
  • Rendering different views
  • Styles
  • default
  • inverted
  • navy
  • red

Was this helpful?

  1. API v2 Reference
  2. Studio

Star Chart

Generates a star chart with the given parameters, and returns the url.

PreviousStudioNextMoon Phase

Last updated 1 year ago

Was this helpful?

If you're looking to quickly integrate this feature on your website without making API calls, checkout

Generate star chart

POST https://api.astronomyapi.com/api/v2/studio/star-chart

Headers

Name
Type
Description

Authorization*

string

Basic <hash>

Request Body

Name
Type
Description

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.

{
 "data": {
     "imageUrl": "https://widgets.astronomyapi.com/star-chart/generated/1234567890.png"
  }
}

Rendering different views

Constellation

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

navy

red

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

📸
✨
Widgets
Contellation Enums