# Relocation API: astrocartography, parans, local space

Relocation astrology answers "where", not "when". AstroWay serves both the **geometry** (lines, crossings, azimuths, angles) and the **meaning** (which line governs what, and what it says) as separate calls, so you decide which layer you need.

## Two layers

**Geometry.** One birth moment projected onto the whole planet: `/v1/acg` returns 67 lines (4 angles × 13 bodies, up to 361 points per line), `/v1/parans` returns over 400 points where two planets were angular at once, `/v1/local-space` returns each planet's azimuth and altitude from the birthplace as great-circle paths.

**Meaning.** `/v1/acg/by-category` takes an area of life and returns the lines that govern it, ranked by weight and, when you pass a point, by proximity to it, with interpretation text attached. The text is curated, from a knowledge base rather than a language model: the same request returns the same words tomorrow.

## Endpoints

| Endpoint | Method | Credits | Purpose |
|---|---|---|---|
| `/v1/acg/categories` | GET | 0 | Taxonomy of 19 life areas: which lines govern what, weight 1-3, polarity |
| `/v1/acg` | POST | Tier 3 | A*C*G lines for every body (alias `/v1/astrocartography`) |
| `/v1/acg/by-category` | POST | Tier 3 | Lines for one life area, ranked, with interpretation |
| `/v1/acg/line-report` | POST | Tier 2 | One line in full: geometry, every area, text |
| `/v1/acg-zones` | POST | Tier 3 | Which lines run near a given point, and how far away |
| `/v1/parans` | POST | Tier 3 | Crossings of two planets' lines, with coordinates |
| `/v1/local-space` | POST | Tier 3 | Azimuth, altitude and great-circle path per planet |
| `/v1/local-space/influence-zone` | POST | Tier 3 | Cone polygon around one azimuth |
| `/v1/relocation` | POST | Tier 3 | Relocated chart: same planets, recomputed houses and angles |
| `/v1/geodetic` | POST | Tier 1 | Geodetic angles from coordinates alone, no birth time |
| `/v1/solar-acg` | POST | Tier 4 | Astrocartography of a given year's solar return |

## 19 life areas

`career` · `success` · `power` · `money` · `wealth` · `love` · `relationship` · `home` · `stability` · `retreat` · `health` · `vitality` · `communication` · `creativity` · `learning` · `spirituality` · `transformation` · `travel` · `adventure`.

Each area names its planet-and-angle lines with a weight from 1 to 3 and a polarity. **Challenging lines are returned alongside supportive ones**: a tool that shows only the favourable ones misrepresents the technique. Want just one kind? Filter with `polarity`.

## Example: rank cities for career

```bash
curl -X POST https://api.astroway.info/v1/acg/by-category \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "date": "1990-05-15", "time": "14:30:00", "timezoneOffset": 3,
        "latitude": 50.45, "longitude": 30.52,
        "category": "career", "point": { "lat": 51.5074, "lng": -0.1278 },
        "radiusDeg": 8, "includeCoordinates": false, "language": "en" }'
# → lines[] with weight, polarity, distanceDeg, strength and interpretation
```

Run the same call once per candidate city and sort on `strength`: the line's weight multiplied by proximity. `includeCoordinates: false` drops the geometry when all you need is the ranking.

## Languages

`language` accepts any active code. The curated knowledge base covers all 40 planet-and-angle combinations in eleven languages (uk, en, de, es, fr, hi, it, ko, pl, pt and more); where a translation is missing the response falls back to en, then uk, and the language actually served is reported in each interpretation's `lang` field.

<Aside type="note">
The taxonomy covers the ten traditional bodies. Chiron, Lilith and the nodes appear in `/v1/acg` geometry but are deliberately outside the life-area mapping: the technique as Jim Lewis defined it does not assign them angular rulership.
</Aside>

Technique pages with examples: [Astrocartography](/en/astrology-api/astrocartography/) · [Interpretations](/en/astrology-api/astrocartography-interpretations/) · [Parans](/en/astrology-api/parans/) · [Local Space](/en/astrology-api/local-space/) · [Relocated Chart](/en/astrology-api/relocated-chart/) · [Geodetic Chart](/en/astrology-api/geodetic-chart/) · [Solar Return Astrocartography](/en/astrology-api/solar-return-astrocartography/)