🌒
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"
}
}
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. Valid values are
default
, sketch
and shaded.
Below are sample moons for each value.
default

shaded

sketch
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.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.
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 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
Last modified 5mo ago