Panchang Chart Image API

Panchang Chart Image

The Panchang Chart Image API generates a rendered visual image of a Panchang chart for a given date, time, and geographic location. It combines the astronomical computation of a Vedic Panchang with a fully customisable chart rendering engine, returning a chart image that can be directly embedded in applications, websites, or printed materials.

What This API Does

This endpoint accepts a date, time, timezone, and geographic coordinates to compute the Panchang for that moment and location. In addition to the astrological inputs, it accepts a comprehensive set of chart styling parameters that control the visual appearance of the output. The API then renders the Panchang data into a chart image according to the specified style and returns it, eliminating the need for any client-side chart rendering logic.

What Data It Returns

The response delivers a rendered Panchang chart image. The image encodes the computed Vedic almanac data for the given date and location in a visual format, including:

• Panchang Chart Layout — A structured chart diagram displaying the Panchang data in the chosen regional style (North Indian, South Indian, or East Indian)

• Zodiac Signs — Displayed as symbols or numbers within the chart, depending on the signSymbol setting

• Planetary Positions — Planets placed within the chart according to their computed sidereal positions, shown as symbols or names based on the planetSymbol setting

• Rendered Visual Elements — Chart borders, inner and outer grid lines, sign labels, and planet labels, all styled according to the provided color and size configuration

Main Use Cases

• Astrology & Jyotish Applications — Embedding ready-made Panchang chart images directly into Vedic astrology apps without building a custom chart renderer

• Hindu Calendar & Almanac Platforms — Displaying a visual daily Panchang chart alongside textual almanac data for a richer user experience

• Kundali & Horoscope Report Generation — Including a Panchang chart image in PDF or web-based horoscope reports for clients

• Religious & Spiritual Portals — Showing a visually styled Panchang chart on daily Panchang pages, festival pages, or puja scheduling tools

• Print & Publishing Tools — Generating chart images for inclusion in printed almanacs, religious booklets, or astrological publications

• White-Label Astrology Products — Producing fully branded chart images by customising colors, sizes, and styles to match a product's visual identity

Key Functionality

• Multiple Chart Styles — Supports North Indian, South Indian, and East Indian chart layouts via the chartStyle parameter, catering to regional Vedic astrology traditions

• Full Visual Customisation — Exposes granular control over every visual aspect of the chart: background color (bgColor), inner and outer line colors and widths (innerLineColor, outerLineColor, innerLineWidth, outerLineWidth), sign color (signColor), planet color (planetColor), chart size (chartSize), and font sizes for signs and planets (signFontSize, planetFontSize)

• Symbol or Text Display — Signs can be rendered as traditional astrological symbols or as numbers (signSymbol), and planets can be shown as symbols or their abbreviated names (planetSymbol), giving flexibility for different audiences

• Server-Side Rendering — The entire chart is rendered on the server, so clients receive a finished image with no dependency on client-side graphics libraries or rendering engines

• Ayanamsha Support — Planetary positions within the chart are computed using the Ayanamsha system specified via the X-Ayanamsha header, ensuring compatibility with different schools of Vedic astrology

• Location-Aware Computation — All Panchang data underlying the chart is calculated for the precise latitude, longitude, and timezone provided, guaranteeing geographic accuracy

• Multi-Language Support — The Accept-Language header allows sign and planet labels within the chart to be rendered in the preferred language, supporting regional and international audiences