Отримайте поточні положення планет з точністю Швейцарських Ефемерид (дані NASA JPL).
Сонце, Місяць, Меркурій, Венера, Марс, Юпітер, Сатурн, Раху, Кету - все в одному виклику API. Підтримка 13 мов.
Надійність корпоративного рівня для планетарних даних
Все для інтеграції відстеження планет в реальному часі
API Планетарних Позицій працює як погодний додаток для планет. Миттєвий доступ до того, де знаходяться 9 планет ЗАРАЗ. Відповідь за 2-7мс з точністю NASA.
Планетарні позиції — це точні розташування планет у зодіаку в будь-який момент часу.
Вимірюються в градусах, хвилинах і секундах вздовж екліптики (шляху, яким рухаються планети).
Приклад: «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 місяців на власну розробку астрономічних розрахунків.
Зосередьтеся на унікальних функціях вашого додатку, а складну математику довірте нам.
Подивіться, як ми виглядаємо на фоні конкурентів
Все про API Планетарних Позицій
Почніть безкоштовно, масштабуйтеся по мірі росту. Ніяких прихованих платежів, ніяких сюрпризів.
Для невеликих додатків та особистих проєктів
Для зростаючих додатків та середнього трафіку
Для корпоративних застосунків
Всі плани включають повну документацію та SDK
Питання? Поговоріть з нашою командою