AstronomyAPI
v2
Search…
⌃K
🌒

Moon Phase

Generate an image of the Moon based on the given parameters.
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/moon-phase
Generate Moon Phase
{
"format": "png",
"style": {
"moonStyle": "sketch",
"backgroundStyle": "stars",
"backgroundColor": "red",
"headingColor": "white",
"textColor": "red"
},
"observer": {
"latitude": 6.56774,
"longitude": 79.88956,
"date": "2020-11-01"
},
"view": {
"type": "portrait-simple",
"orientation": "south-up"
}
}

Format

The API currently supports outputting images in svg and png formats. These can be used in different use cases, depending on how and where you want them to be displayed.

Style

moonStyle

Valid values are default, sketch and shaded. Below are sample moons for each value.
default
shaded
sketch

backgroundStyle

Background style supports the values either stars or solid. Passing stars will render a stars background while solid will render the background with a solid color specified by the backgroundColor property.

backgroundColor, headingColor and textColor

These properties could be used to customize the image further. Colors could be defined as hex or as any of the 140 html color names.

View

type

The type parameter in the view object should specify which template to be used when rendering the image. Currently two templates are available.
portrait-simple
landscape-simple

orientation

Orientation parameter in the view object, determines which orientation to use when rendering the moon. By default it will render north side up, as seen by an observer facing the south side of the sky. This parameter is optional.
Below is an example of the same image with different orientations.
north-up
south-up