Parans API

Endpoint ini mengubah momen kelahiran menjadi Julian day, menghitung set lengkap astrocartography (empat garis angular per benda), lalu memotong setiap garis dengan semua garis milik planet lain. Setiap persilangan dikembalikan bersama kedua planet induk, kedua tipe garis, serta lintang dan bujur tempat persilangan terjadi. Karena garis MC dan IC adalah meridian dan garis AC serta DC bergantung pada lintang, kebanyakan persilangan bersifat geometris bukan simetris: pasangan Sun-MC dan Moon-ASC bertemu di satu tempat per belahan bumi, bukan pada pita bersama. Chart tipikal menghasilkan lebih dari empat ratus persilangan di seluruh dunia, makanya hasilnya berupa daftar datar yang dapat disortir, bukan dipfilter dulu berdasarkan pentingnya.

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 }
      }
    ]
  }
}

Gunakan parans kalau garis astrocartography saja terlalu kasar. Garis memberi tahu pengguna bahwa koridor membawa Jupiter; parans memberi tahu bahwa di satu titik spesifik pada koridor itu Jupiter bertemu Venus. Perbedaan inilah yang dibayar oleh konsultan relokasi, dan biasanya diabaikan oleh kebanyakan alat peta. Praktisnya: render garis sebagai polyline dan parans sebagai marker yang dapat diklik, atau filter daftar ke pasangan planet yang penting bagi produkmu dan urutkan kota terdekat berdasarkan jarak ke titik-titik itu. Responsnya hanya koordinat, jadi kamu bisa menggabungkannya dengan dataset kota atau wilayah milikmu tanpa harus mengurai format teks. Perlu dicatat endpoint ini tidak memerlukan tempat lahir, hanya momen, karena persilangan adalah properti langit, bukan lokasi orang.

Posisi diambil dari Swiss Ephemeris (Astrodienst), mesin yang sama dengan endpoint natal, jadi parans berakar pada longitude planet yang sama dengan garis yang mereka turunkan. Persilangan dihitung dalam zodiac tropis dari geometri lengkap garis, bukan dari perkiraan lintang. Doktrin klasik paran menurut Bernadette Brady juga memperlakukan star-to-planet parans, dan melaporkannya sebagai lintang bukan titik; kasus itu punya endpoint sendiri, [star-planet parans](/astrology-api/star-parans/). Yang ini mencakup kasus planet-to-planet yang dihasilkan oleh peta astrocartography itu sendiri.