astro_render_map
Geographic chart renders — astrocartography, local space, eclipse paths, horizon.
- Layer: render
- Methods: astrocartography, local-space, eclipse-path, local-horizon
- Free tier: —
- Paid tier: astrocartography, local-space, eclipse-path, local-horizon
Description
Geographic chart renders — astrocartography, local space, eclipse paths, horizon.
Methods:
astrocartography [Paid] — astrocartography world map of planetary MC/IC/ASC/DSC lines for a birth chart
local-space [Paid] — local-space star-map showing each planet's azimuth bearing from the birth location
eclipse-path [Paid] — world map of the central path of the next solar eclipse after the given date
local-horizon [Paid] — local horizon circle plotting each planet's azimuth + altitude at the birth location
Input schema
astrocartography
| Field | Type | Required | Constraints |
|---|---|---|---|
| birthData.year | integer | yes | min -4000, max 4000, int |
| birthData.month | integer | yes | min 1, max 12, int |
| birthData.day | integer | yes | min 1, max 31, int |
| birthData.hour | integer | yes | min 0, max 23, int |
| birthData.minute | integer | yes | min 0, max 59, int |
| birthData.second | integer | no | min 0, max 59, int |
| birthData.latitude | number | yes | min -90, max 90 |
| birthData.longitude | number | yes | min -180, max 180 |
| birthData.timezone | number | yes | min -12, max 14 |
| birthData.unknownTime | boolean | no | — |
| planets | array<enum(10)> | no | — |
| lines | array<"mc" | "ic" | "asc" | "dsc"> | no | — |
| mode | "light" | "dark" | no | — |
Example request
{
"method": "astrocartography",
"birthData": {
"year": 1990,
"month": 1,
"day": 1,
"hour": 12,
"minute": 0,
"latitude": 51.5074,
"longitude": -0.1278,
"timezone": 0
}
}
Example response (captured; long values elided)
{
"svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"1000\" height=\"728\" viewBox=\"0 0 1000 728\"><rect width=\"1000\" height=\"728\"… (344559 chars total)",
"lines": [
{
"planet": "Sun",
"kind": "mc",
"meridianLon": 0.880306,
"points": null
},
{
"planet": "Sun",
"kind": "ic",
"meridianLon": -179.119694,
"points": null
},
{
"planet": "Sun",
"kind": "asc",
"meridianLon": null,
"points": [
[
-179.119692,
-66.998139
],
[
-175.131856,
-66.948139
],
[
-171.163648,
-66.798139
],
[
-166.601358,
-66.498139
],
[
-161.573106,
-66
],
[
-154.676417,
-65
],
[
-149.62263,
-64
],
[
-145.543795,
-63
],
"… 133 more items"
]
},
{
"planet": "Sun",
"kind": "dsc",
"meridianLon": null,
"points": [
[
-179.119696,
-66.998139
]
]
},
{
"planet": "Sun",
"kind": "dsc",
"meridianLon": null,
"points": [
[
176.892469,
-66.948139
],
[
172.924261,
-66.798139
],
[
168.36197,
-66.498139
],
[
163.333718,
-66
],
[
156.437029,
-65
],
[
151.383242,
-64
],
[
147.304408,
-63
],
[
143.857234,
-62
],
"… 132 more items"
]
},
{
"planet": "Moon",
"kind": "mc",
"meridianLon": 53.78073,
"points": null
},
{
"planet": "Moon",
"kind": "ic",
"meridianLon": -126.21927,
"points": null
},
{
"planet": "Moon",
"kind": "asc",
"meridianLon": null,
"points": [
[
-126.219268,
-81.063175
],
[
-120.122951,
-81.013175
],
[
-114.109481,
-80.863175
],
[
-107.325819,
-80.563175
],
[
-119.370796,
-81
],
[
-99.323866,
-80
],
[
-90.217961,
-79
],
[
-83.935663,
-78
],
"… 163 more items"
]
},
"… 41 more items"
]
}
Rendered example
local-space
| Field | Type | Required | Constraints |
|---|---|---|---|
| birthData.year | integer | yes | min -4000, max 4000, int |
| birthData.month | integer | yes | min 1, max 12, int |
| birthData.day | integer | yes | min 1, max 31, int |
| birthData.hour | integer | yes | min 0, max 23, int |
| birthData.minute | integer | yes | min 0, max 59, int |
| birthData.second | integer | no | min 0, max 59, int |
| birthData.latitude | number | yes | min -90, max 90 |
| birthData.longitude | number | yes | min -180, max 180 |
| birthData.timezone | number | yes | min -12, max 14 |
| birthData.unknownTime | boolean | no | — |
| planets | array<enum(10)> | no | — |
| mode | "light" | "dark" | no | — |
Example request
{
"method": "local-space",
"birthData": {
"year": 1990,
"month": 1,
"day": 1,
"hour": 12,
"minute": 0,
"latitude": 51.5074,
"longitude": -0.1278,
"timezone": 0
}
}
Example response (captured; long values elided)
{
"svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"760\" height=\"935\" viewBox=\"0 0 760 935\">\n<defs>\n<path id=\"wm-admetos\" d=\"… (132216 chars total)",
"vectors": [
{
"planet": "Sun",
"azimuth": 179.037095,
"altitude": 15.485467
},
{
"planet": "Moon",
"azimuth": 124.671277,
"altitude": 13.922598
},
{
"planet": "Mercury",
"azimuth": 163.602878,
"altitude": 16.610494
},
{
"planet": "Venus",
"azimuth": 152.532847,
"altitude": 17.563224
},
{
"planet": "Mars",
"azimuth": 210.429454,
"altitude": 11.20461
},
{
"planet": "Jupiter",
"azimuth": 4.900853,
"altitude": -15.130314
},
{
"planet": "Saturn",
"azimuth": 174.030431,
"altitude": 16.059419
},
{
"planet": "Uranus",
"azimuth": 184.206748,
"altitude": 14.805485
},
"… 2 more items"
]
}
Rendered example
eclipse-path
| Field | Type | Required | Constraints |
|---|---|---|---|
| date.year | integer | yes | min 1800, max 2200, int |
| date.month | integer | yes | min 1, max 12, int |
| date.day | integer | yes | min 1, max 31, int |
| mode | "light" | "dark" | no | — |
Example request
{
"method": "eclipse-path",
"date": {
"year": 2024,
"month": 4,
"day": 8
}
}
Example response (captured; long values elided)
{
"svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"1000\" height=\"704\" viewBox=\"0 0 1000 704\"><rect width=\"1000\" height=\"704\"… (202922 chars total)",
"jdMax": 2460409.262041,
"eclipseType": "total",
"centralPath": [
[
-155.814063,
-7.416569
],
[
-148.385105,
-5.893844
],
[
-144.7253,
-4.881648
],
[
-139.776484,
-3.186917
],
[
-136.184462,
-1.686541
],
[
-133.295444,
-0.290652
],
[
-130.852122,
1.036632
],
[
-128.721274,
2.31417
],
"… 47 more items"
]
}
Rendered example
local-horizon
| Field | Type | Required | Constraints |
|---|---|---|---|
| birthData.year | integer | yes | min -4000, max 4000, int |
| birthData.month | integer | yes | min 1, max 12, int |
| birthData.day | integer | yes | min 1, max 31, int |
| birthData.hour | integer | yes | min 0, max 23, int |
| birthData.minute | integer | yes | min 0, max 59, int |
| birthData.second | integer | no | min 0, max 59, int |
| birthData.latitude | number | yes | min -90, max 90 |
| birthData.longitude | number | yes | min -180, max 180 |
| birthData.timezone | number | yes | min -12, max 14 |
| birthData.unknownTime | boolean | no | — |
| planets | array<enum(10)> | no | — |
| mode | "light" | "dark" | no | — |
Example request
{
"method": "local-horizon",
"birthData": {
"year": 1990,
"month": 1,
"day": 1,
"hour": 12,
"minute": 0,
"latitude": 51.5074,
"longitude": -0.1278,
"timezone": 0
}
}
Example response (captured; long values elided)
{
"svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"760\" height=\"935\" viewBox=\"0 0 760 935\">\n<defs>\n<path id=\"wm-admetos\" d=\"… (130911 chars total)",
"positions": [
{
"planet": "Sun",
"azimuth": 179.037095,
"altitude": 15.485467,
"visible": true
},
{
"planet": "Moon",
"azimuth": 124.671277,
"altitude": 13.922598,
"visible": true
},
{
"planet": "Mercury",
"azimuth": 163.602878,
"altitude": 16.610494,
"visible": true
},
{
"planet": "Venus",
"azimuth": 152.532847,
"altitude": 17.563224,
"visible": true
},
{
"planet": "Mars",
"azimuth": 210.429454,
"altitude": 11.20461,
"visible": true
},
{
"planet": "Jupiter",
"azimuth": 4.900853,
"altitude": -15.130314,
"visible": false
},
{
"planet": "Saturn",
"azimuth": 174.030431,
"altitude": 16.059419,
"visible": true
},
{
"planet": "Uranus",
"azimuth": 184.206748,
"altitude": 14.805485,
"visible": true
},
"… 2 more items"
]
}
Rendered example
