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
Parameters
Header
Authorization*
string
Basic <hash>
Body
format
string
Image format to be returned. Valid values are png or svg. Defaults to png
style
object
Style object contains the styling parameters for the image generated.
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 object.
orientation specifies which side of the moon should be up depending on the hemisphere you live in the world. This parameter is optional. If not provided AstronomyAPI will determine the values automatically.
Responses
200: OK
{
"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