Render Astrocartography Map (SVG)
GET
/api/astrocartography/map.svg
Render an astrocartography world map showing planetary lines for a birth moment.
Each line shows where a planet is angular (conjunct an angle) at that moment:
- MC lines (solid vertical): Where the planet culminates (on the Midheaven)
- IC lines (dashed vertical): Where the planet is at the lowest point (Imum Coeli)
- ASC lines (solid curved): Where the planet is rising (on the Ascendant)
- DSC lines (dashed curved): Where the planet is setting (on the Descendant)
Required parameters:
- dateTime: Birth date/time (YYYY-MM-DDTHH:mm)
- location.longitude, location.latitude, location.timezone: Birth location
Optional parameters:
- width, height: Map dimensions (default: 1200x600)
- projection: Map projection (equirectangular, naturalEarth1, mercator)
- showLabels, showLegend, showGraticule: Toggle map features (true/false)
- backgroundColor, landColor, oceanColor, borderColor, graticuleColor: Custom colors (hex)
- lineWidth: Line thickness in pixels
Authorizations
ApiKeyAuth
API key for authentication. Get your API key from the dashboard.
Type
API Key (header: X-Api-Key)
Parameters
Query Parameters
dateTime*
Birth date/time (YYYY-MM-DDTHH:mm)
Type
Requiredstring
location.longitude*
Birth longitude in decimal degrees
Type
Requiredstring
location.latitude*
Birth latitude in decimal degrees
Type
Requiredstring
location.timezone*
IANA timezone identifier
Type
Requiredstring
width
Map width in pixels
Type
string
Default
"1200"height
Map height in pixels
Type
string
Default
"600"projection
Map projection type
Type
string
Valid values
"equirectangular""naturalEarth1""mercator"Default
"equirectangular"showLabels
Show planet line labels
Type
string
Default
"true"showLegend
Show planet legend
Type
string
Default
"true"showGraticule
Show grid lines
Type
string
Default
"true"backgroundColor
Background color (hex)
Type
string
landColor
Land color (hex)
Type
string
oceanColor
Ocean color (hex)
Type
string
borderColor
Country border color (hex)
Type
string
graticuleColor
Graticule grid line color (hex)
Type
string
lineWidth
Line width in pixels
Type
string
Responses
Astrocartography map rendered successfully
image/svg+xml
JSON
[
]