API паранів

Ендпоінт переводить момент народження в юліанський день, обчислює повний набір астрокартографії (чотири кутові лінії на кожне тіло), а потім перетинає кожну лінію з кожною лінією іншої планети. Кожен перетин повертається з обома планетами, обома типами ліній та широтою й довготою, де він припадає. Оскільки лінії MC та IC це меридіани, а лінії AC та DC це криві, залежні від широти, більшість перетинів геометричні, а не симетричні: пара Сонце-MC і Місяць-ASC зустрічається рівно в одному місці на півкулю, а не на спільній смузі. Типова карта дає понад чотириста перетинів по всій земній кулі, тому вони повертаються пласким списком, придатним до сортування, без попереднього відсіювання за якимось уявленням про важливість.

curl -X POST https://api.astroway.info/v1/parans \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3
}'

{
  "ok": true,
  "data": {
    "count": 414,
    "parans": [
      {
        "planet1Id": 0,
        "planet1Name": "Sun",
        "line1Type": "MC",
        "planet2Id": 1,
        "planet2Name": "Moon",
        "line2Type": "ASC",
        "location": { "lat": -45.9153, "lng": 6.5735 }
      }
    ]
  }
}

Беріть парани тоді, коли самих ліній астрокартографії замало. Лінія каже користувачеві, що коридор несе Юпітер; паран каже, що в одній конкретній точці цього коридору Юпітер зустрічається з Венерою. Саме за цю різницю беруть гроші консультанти з релокації, і саме цей шар пропускає більшість картографічних інструментів. На практиці: рендеріть лінії полілініями, а парани клікабельними маркерами, або відфільтруйте список до тих пар планет, які цікавлять ваш продукт, і відранжуйте міста поблизу за відстанню до цих точок. Відповідь містить лише координати, тож ви можете з'єднати її з власним набором міст або регіонів, не воюючи з текстовим форматом. Зверніть увагу: місце народження цьому ендпоінту не потрібне, лише момент, бо перетини є властивістю неба, а не того, де саме перебувала людина.

Позиції беруться зі Swiss Ephemeris (Astrodienst), скомпільованого у WASM, того самого рушія, що й натальні ендпоінти, тож парани прив'язані до тих самих довгот планет, що й лінії, з яких вони походять. Перетини обчислюються у тропічному зодіаку з повної геометрії ліній, а не з широтного наближення. Класична доктрина паранів у викладі Бернадетт Брейді розглядає також парани зірка-планета у спільній широтній смузі; цей ендпоінт покриває випадок планета-планета, який породжує сама астрокартографічна карта.