astrocartography

Astrocartography (ACG / Locational Astrology)

Use this skill when someone asks where on Earth they're "luckiest" for love, career, growth, or healing — or what changes if they move. ACG maps the four angular positions (rising, culminating, setting, anti-culminating) of every planet at the moment of birth across the globe, producing planetary lines. Living near a line activates that planet's energy in the corresponding angular theme.

Tier requirement: Power lines, CCG, hits and local space need the Pro tier ($29/mo); ACG calls cost 10 credits. Aspects, midpoints, crossings, declinations, parans, hermetic lines and the relational endpoints need Scale ($199/mo). The combined /acg/features endpoint is service-tier (Ela Map only).

Required Information

1. Full birth date
2. Birth time (essential — ACG IS the angular system; time uncertainty wrecks it)
3. Birth location
4. (Optional but useful) One or more target locations the user is asking about, OR a desired theme (career, love, healing, spirituality) to find the best lines for that theme.

Standard Procedure for Birth-Data Endpoints

Any endpoint that takes a birth chart (natal, synastry, composite, transits, returns, progressions, Human Design, Vedic, ACG) MUST follow this sequence. Skipping any step produces a wrong chart — usually wrong by hours of arc.

Step 1 — Resolve location to coordinates

If you don't already have precise lat/lon, call:

GET /location/autocomplete?query=<city, country>&limit=5

Confirm the right hit with the user if there's ambiguity (e.g. "Portland, OR" vs "Portland, ME"). Record the latitude and longitude of the chosen result.

Step 2 — Resolve timezone for that location AT THE BIRTH DATE

Historical timezone rules matter. A city's UTC offset in 1962 may differ from today (DST rules, war time, jurisdiction changes). Always look up the timezone for the specific birth date.

POST /timezone/lookup
{ "latitude": <lat>, "longitude": <lon> }