By topic / Astrocartography API
Astrocartography API: planetary lines on a world map
Get the MC, IC, ascendant and descendant lines as coordinates or a drawn world map, filter them by planet or life goal, rank cities, and cast a relocated chart.
What people build with it
- A relocation feature in a travel app
- City rankings
- Location reports
The endpoints
- Astrocartography Map
A world map image of the planetary lines for a birth, with filters by planet, line and life goal.
POST /v1/location-astrology/acg-map
3 credits
- Transit Astrocartography Map
A world map image of the planetary lines at any moment, with filters by planet and line.
POST /v1/location-astrology/transit-acg-map
1 credit
- Astrocartography Lines
All planetary ASC/MC/DC/IC lines for a birth moment as map line segments, plus aspect lines, zenith points, parans and midheaven sign bands.
POST /v1/location-astrology/acg-lines
1 credit
- Best Cities for a Goal
Ranks catalogue cities for one life goal: score, distance, rising and midheaven signs with their lords, and the reasons for each.
POST /v1/location-astrology/rank-cities
3 credits
- Relocated Chart
The chart recast for a new place: angles, house cusps with their lords, and each planet's house there and at the birthplace.
POST /v1/location-astrology/relocation-chart
1 credit
- Compare Two Places
Scores two places per goal under the same birth and date, with each place's angles and KP verdicts, the totals and the overall winner.
POST /v1/location-astrology/compare-locations
1 credit
- Relocation Report
Relocation reading: relocation potential, stay-or-move verdict, foreign settlement, best directions, house and D4 analysis, dasha support, ranked places, timing and a confidence statement.
POST /v1/reports/report-relocation
10 credits
Common questions
- Do I need a map library?
- No. acg-map returns a finished SVG map. Use acg-lines if you draw your own.

