API de relocalização

O endpoint relocation calcula o mapa natal a partir dos dados de nascimento fornecidos e depois volta a levantar a estrutura de casas para uma segunda localização, deixando as posições planetárias intactas. Os planetas mantêm os signos e graus com que se nasceu — são função do momento, não do lugar — mas o Ascendente, o Meio-Céu e todas as cúspides das casas são recalculados a partir da latitude e longitude-alvo, o que reatribui cada planeta a uma nova casa. A resposta devolve lado a lado o mapa natal original e o mapa relocalizado, mais um objeto delta que relata o quanto os ângulos se moveram: ascendantShift e mcShift. Esse delta quantifica com que força a relocalização remodela a ênfase do mapa — um grande desvio significa que as casas, e portanto as áreas da vida que um planeta ativa, mudam substancialmente, mesmo que os próprios planetas não se tenham mexido.

curl -X POST https://api.astroway.info/v1/relocation \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "natal": {
    "date": "1990-05-15",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.45,
    "longitude": 30.52
  },
  "target": {
    "latitude": 40.71,
    "longitude": -74.01,
    "city": "New York"
  }
}'

{
  "ok": true,
  "data": {
    "natal": {
      "houses": {
        "ascendant": 160.4,
        "mc": 70.1
      }
    },
    "relocated": {
      "houses": {
        "ascendant": 243.8,
        "mc": 152.6
      }
    },
    "delta": {
      "ascendantShift": 83.4,
      "mcShift": 82.5
    }
  }
}

Use o mapa de relocalização para questões adjacentes à astrocartografia — "como se leria o meu mapa se eu vivesse nesta cidade", um relatório de relocalização para alguém que pondera uma mudança, ou uma funcionalidade de viagens que mostra que casas se acendem num destino. É a chamada natural sempre que a localização importa mas os dados de nascimento são fixos: a constituição planetária mantém-se constante, apenas a ênfase angular e de casas muda. Devolver ambos os mapas e o delta angular numa só resposta permite apresentar diretamente um antes-e-depois, e o delta facilita assinalar relocalizações que mal mudam algo face às que deslocam o Ascendente ou o Meio-Céu por um signo ou mais. Alimente as casas relocalizadas à interpretação para descrever como um lugar muda a ênfase sentida do mesmo nascimento.

Apenas a estrutura de casas é relocalizada; as longitudes planetárias, os signos e os aspetos entre planetas são idênticos aos do mapa natal, pois dependem do momento de nascimento, não do lugar. A resposta carrega ambos os mapas mais um delta {ascendantShift, mcShift} para que possa medir o movimento angular. O alvo aceita um rótulo de cidade opcional para exibição. As casas seguem o sistema escolhido; zodíaco tropical e Swiss Ephemeris ao longo de tudo.