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 das mesmas efemérides 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.