Вайшнавський календар, за яким живе ISKCON: повний рік екадаші, дні явлення та відходу ачар’їв і головні свята, датовані за гаудія-ліком, а не за загальноіндуїстським. Місяці названо дванадцятьма іменами Вішну — Madhava, Govinda, Damodara та інші, — дві пакші звуться Krishna і Gaura, а роки лічать за ерою Гаурабда.
Передайте рік разом із latitude, longitude і зміщенням від UTC: на який цивільний день припадає обряд, визначає тітхі, чинна на момент місцевого сходу Сонця. Відповідь — {year, events}, кожна подія — {name, date, masa, paksa, tithi_number, is_adhika, gaurabda_year}, тож ви отримуєте і григоріанську дату, і вайшнавські координати, з яких її обчислено; is_adhika позначає подію в адхіка-місяці.
Тітхі й місяці обчислюються за специфікацією GCAL, на якій працює власна календарна програма ISKCON. Це свідомо не той метод на основі сидеричних ефемерид, що стоїть за /api/astro/panchanga/, тож дати можуть на день відрізнятися від інших ендпоінтів цього API. За рік повертається кілька сотень подій, тому фільтруйте їх або розбивайте на сторінки на боці клієнта.
Поля запиту
Поле
Тип
Обов’язкове
Примітки
latitude
number (double)
обов’язковий
Широта місця в десяткових градусах. Додатні значення — північ, від’ємні — південь. Приклад: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Хвилини й секунди не приймаються — спершу переведіть їх у градуси.
longitude
number (double)
обов’язковий
Довгота місця в десяткових градусах. Додатні значення — схід, від’ємні — захід. Приклад: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Зверніть увагу на знак: без мінуса Нью-Йорк опиниться в Китаї.
timezone_as_float
number (double)
обов’язковий
Зміщення місця від UTC у годинах, десятковим дробом. Приклад: 5.5 для Індії (UTC+05:30), -5 для Нью-Йорка взимку, 5.75 для Непалу. Його НЕ звіряють із date_time: якщо значення розходяться, ви отримаєте успішну відповідь для неправильного моменту, тож беріть обидва з одного джерела. Використовуйте зміщення, чинне на ту дату, а не сьогоднішнє: для народження влітку в країні з переходом на літній час потрібне літнє зміщення.