API de astrocartografia

A partir da data de nascimento, hora de relógio, desvio UTC e coordenadas de nascimento, o endpoint fixa o céu exato desse instante e depois varre o globo para encontrar cada meridiano e curva onde um planeta esteve sobre um dos quatro ângulos. Para cada um dos dez planetas mais os nodos, traça quatro famílias de linha: a linha de ascensão, onde o corpo estava no Ascendente; a linha de poente, no Descendente; a linha de culminação, no Meio-Céu; e a linha de anti-culminação, no Imum Coeli. As linhas do MC e do IC correm como meridianos limpos; as linhas do AC e do DC curvam-se como curvas dependentes da latitude, uma vez que um corpo que nasce a leste numa latitude nasce muito mais a norte ou a sul noutra. Tudo é devolvido como geometria de linhas serializável em data.lines, pronta a alimentar diretamente uma biblioteca de mapas. Esta é a técnica de relocalização popularizada por Jim Lewis como Astro*Carto*Graphy.

curl -X POST https://api.astroway.info/v1/astrocartography \
  -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
}'

{
  "ok": true,
  "data": {
    "lines": [
      {
        "planet": "Venus",
        "type": "MC",
        "longitude": 14.2
      },
      {
        "planet": "Jupiter",
        "type": "AC",
        "points": [
          "…"
        ]
      }
    ]
  }
}

Use este endpoint quando a localização é a variável e quer saber como um mapa se reexpressa ao longo do mapa-múndi — para aconselhamento de relocalização, ferramentas de viagens e de onde-viver, ou qualquer funcionalidade que sobreponha o mapa de uma pessoa a um globo. É o backend natural para um mapa interativo: solicite as linhas uma vez para um momento de nascimento, renderize-as como polilinhas e deixe o utilizador percorrer continentes para ler que planeta governa que corredor. Como a saída é geometria pura em vez de prosa, compõe-se de forma limpa com a sua própria estilização de front-end, agrupamento e camadas de clicar-para-interpretar. Combine-o com a chamada natal-chart quando quiser tanto a estrutura do mapa de origem como as linhas relocalizadas lado a lado; ambos partilham a mesma resolução de nascimento, pelo que as posições planetárias por trás do mapa concordam exatamente.

As posições provêm do Swiss Ephemeris (Astrodienst) compilado para WASM, o mesmo motor por trás dos endpoints natais, pelo que as linhas se ancoram nas longitudes planetárias idênticas. A angularidade é calculada no zodíaco tropical. A resposta carrega apenas geometria — o desenho, a projeção e a estilização do mapa-múndi ficam a cargo do seu cliente.