Відстежуй всі 9 планет в Реальному Часі <10мс

Планетарні позиції — це точні розташування планет у зодіаку в будь-який момент часу.

Вимірюються в градусах, хвилинах і секундах вздовж екліптики (шляху, яким рухаються планети).

Приклад: «Sun at 15° Aries 23' 12"» означає, що Сонце знаходиться на 15 градусі, 23 кутових хвилинах і 12 кутових секундах знаку Овна.

Чому це важливо? В астрології МІСЦЕПОЛОЖЕННЯ планети визначає, НА ЩО вона впливає.

Сонце в Овні = впевнена, ініціативна енергія.

Сонце в Рибах = співчутлива, мрійлива енергія.

Для натальних карт потрібні позиції на момент народження.

Для щоденних гороскопів — ПОЗИЦІЇ СЬОГОДНІ.

Для прогнозів транзитів порівнюють поточні позиції з натальними.

Планети постійно змінюють положення — Місяць найшвидший (13°/день), Сатурн найповільніший (0,03°/день).

Додатки, що використовують застарілі дані, дають хибні прогнози.

Це як користуватися вчорашнім прогнозом погоди для сьогодні — марно.

Наш API відстежує всі 9 планет 24/7 за допомогою Swiss Ephemeris (дані NASA JPL) — той самий обчислювальний движок, що використовує NASA.

Час відповіді <300ms гарантує миттєве отримання точних даних без затримок «завантаження...».

Необхідно для будь-якого серйозного астрологічного додатку.

Точне відстеження планет потребує трьох складових: (1) астрономічних ефемеридних даних — ми використовуємо Swiss Ephemeris, заснований на планетарних теоріях NASA JPL, (2) точних часових розрахунків — планети рухаються по секундах, а не лише по днях, (3) конвертації систем координат — тропічний проти сидеричного зодіаку з 12 системами аянгамс.

Як це працює: Swiss Ephemeris містить математичні формули (не таблиці) для обчислення положень планет на БУДЬ-ЯКУ дату/час від 3000 року до н.е.

до 3000 року н.е.

Коли надходить запит «положення планет 5 січня 2025 року о 15:42 UTC», наш API обчислює точну екліптичну довготу (градусне положення вздовж зодіакального поясу), схилення (північ/південь від небесного екватора) та відстань від Землі.

Потім конвертує у потрібну систему зодіаку — тропічну (залежну від сезонів, використовується у західній астрології) або сидеричну (зоряну, застосовується у ведичній астрології).

Підтримуємо 12 систем аянгамс, включно з Lahiri, Raman, Krishnamurti.

Різниця наразі близько 24 градусів через прецесію рівнодень.

Ручний розрахунок вимагає ефемеридних книг, інтерполяції між датами, конвертації координат — займає 5-10 хвилин на планету.

Наш API робить це для 9 планет за <300ms з точністю 0.001°.

Професійне програмне забезпечення, як Solar Fire, використовує той самий движок Swiss Ephemeris — ми ж робимо його доступним через API 13 мовами (8 індійських + 5 європейських).

Тропічний зодіак (західна астрологія) фіксує 0° Овна на весняному рівноденні — коли день і ніч однакової тривалості.

Тож тропічний Овен ЗАВЖДИ починається близько 20-21 березня.

Сідеричний зодіак (ведична астрологія) фіксує 0° Овна на фактичних сузір’ях зірок.

Але Земля коливається на осі (прецесія), тому точка рівнодення поступово зміщується назад сузір’ями приблизно на 1° кожні 72 роки.

Наразі тропічний і сідеричний зодіаки розділені приблизно на 24°.

Цей розрив називається «аянансою».

Підтримується 12 систем аянанси — Lahiri, Raman, Krishnamurti (KP) та інші.

Практичний приклад: якщо тропічне Сонце на 10° Овна, то сідеричне Сонце (з аянансою Lahiri) буде близько 16° Риб.

Ваш західний знак Сонця може бути Овен, а ведичний — Риби.

Наш API обчислює ОБИДВІ системи.

Вкажіть ayanamsa: null для тропічної або ayanamsa: "lahiri" для сідеричної.

Можна отримати обидва варіанти в одній відповіді — корисно для додатків з глобальною аудиторією (західна популярна в США/Європі, ведична — в Індії).

Не потрібно інтегрувати два окремі API.

Один виклик, обидві системи, час відповіді <300ms.

Конкуренти змушують обирати між західною АБО ведичною — ми даємо обидві з 12 варіантами аянанси.

Планети рухаються з дуже різною швидкістю.

Місяць: 13° на день (змінює знак Зодіаку приблизно кожні 2,5 дні).

Сонце: 1° на день (змінює знак щомісяця).

Меркурій: 1-2° на день при прямому русі, під час ретроградності здається рухається назад.

Венера: в середньому 1° на день.

Марс: в середньому 0,5° на день.

Юпітер: 0,08° на день (5 кутових хвилин).

Сатурн: 0,03° на день (2 кутові хвилини).

Раху/Кету (лунні вузли): рухаються назад зі швидкістю 0,05° на день.

Для щоденних гороскопів оновлення достатнє раз на добу опівночі (позиція Місяця найважливіша).

Для сповіщень про транзити в реальному часі («Місяць зараз входить у ваш 7-й дім») оновлення кожні кілька годин.

Для розрахунку натальної карти — одноразове отримання даних у момент народження.

Для астропогодних панелей, що показують «планети зараз», оновлення кожні 15-60 хвилин.

Наш API розроблений для високочастотних запитів — кешується на 5 хвилин (позиції планет за 5 хвилин суттєво не змінюються), тому можна робити виклики щохвилини без втрати продуктивності.

На відміну від ефемерид, які публікують позиції раз на добу опівночі, наш API обчислює для БУДЬ-ЯКОГО часу — якщо потрібні позиції на 15:42 конкретної дати, отримуєте точні позиції саме на цей момент, а не наближення до опівночі.

Це критично для точного визначення часу.

Транзит = де планети ЗАРАЗ у порівнянні з їхнім розташуванням у момент вашого народження.

Наприклад: ви народилися з Сонцем на 10° Овна.

Сьогодні транзитний Юпітер на 10° Овна — це Юпітерове повернення (відбувається кожні 12 років).

Період значного життєвого розширення.

Або транзитний Сатурн у опозиції до вашого натального Місяця — складний емоційний період.

Додатки використовують транзити для: (1) Щоденних прогнозів — «Марс транзитує ваш 10-й дім: кар’єрний прорив цього тижня», (2) Систем сповіщень — «Венера завтра входить у ваш 7-й дім: сприятливо для романтики», (3) Відстеження важливих транзитів — Сатурнове повернення, Юпітерове повернення, Уранова опозиція у 42 роки.

Для реалізації: один раз отримати натальну карту користувача (натальні позиції) та зберегти її.

Потім щодня або щогодини викликати наш API для отримання поточних позицій.

Порівнювати поточні позиції з натальними: кон’юнкція (0°), опозиція (180°), трин (120°), квадрат (90°), секстиль (60°).

Генерувати прогнози на основі аспектів.

Професійний тариф ($37/міс) включає endpoint для розрахунку транзитів, який автоматично робить порівняння — ви надсилаєте натальні дані + поточну дату, отримуєте всі активні транзити з інтерпретаціями.

Значно простіше, ніж писати код для виявлення аспектів самостійно.

У відповіді є орбіс (наскільки точний аспект), застосування/розрив (чи аспект посилюється чи слабшає), дата піку (коли аспект точний).

Важливо для прогнозів, що залежать від часу.

Інтеграція проста: 3 кроки.

(1) Отримайте API-ключ – безкоштовний тариф включає 50 {{requests}} на місяць,.

(2) Надішліть POST-запит з датою/часом і локацією (локація потрібна для позицій будинків, опційно для базових позицій планет).

(3) Обробіть JSON-відповідь з даними планет.

Приклад коду: const response = await fetch(API_URL, {method: "POST", headers: {Authorization: "Bearer API_KEY"}, body: JSON.stringify({year: 2025, month: 1, day: 5, hour: 15, minute: 42, latitude: 40.7, longitude: -74.0})}); const planets = await response.json(); console.log(planets.sun.longitude); – готово! У відповіді для кожної планети: довгота (позиція в градусах), знак (Aries/Taurus/тощо), градус у знаку, статус ретроградності, швидкість (добове рухання), деклінація, відстань від Землі.

Варіанти використання: (1) віджет «Planets Today» – показ усіх поточних позицій, (2) трекер ретроградності – фільтрація планет зі значенням is_retrograde: true, (3) сповіщення про зміну знаку – порівняння знаку вчора і сьогодні, (4) генератор натальної карти – збереження позицій на момент народження.

Надаємо SDK для JavaScript, Python, PHP з допоміжними функціями.

Інтеграція займає 2-3 години замість 3-6 місяців на власну розробку астрономічних розрахунків.

Зосередьтеся на унікальних функціях вашого додатку, а складну математику довірте нам.