Vedic FAQ

Sepsali jsme otázky, které se často objevují při integraci védských endpointů. Pokud jste odpověď nenašli, napište na hello@astroway.info a doplníme ji.

Jaké ayanamshy jsou podporované? Kterou zvolit?

API podporuje 9 ayanamsh:

Kód	Název	Kdy ji zvolit
`lahiri` (default)	Chitra Paksha	Standard indické vlády, největší masový trh. Pro většinu védských aplikací je to ona.
`raman`	B.V. Raman	Pokud integrujete mobilní aplikaci pro jihoindický trh (Karnataka, Tamil Nadu).
`krishnamurti` (alias `kp`)	KP	Pokud voláte `/v1/vedic/kp/*` - KP má vlastní ayanamshu.
`yukteshwar`	Sri Yukteshwar	Vzdálenost od Spiky; teosofické publikum nebo publikum s blízkostí k západní astrologii.
`fagan-bradley`	Fagan/Bradley	Západní siderická astrologie (ne védská). Pro astrology, kteří přecházejí ze západních siderických tradic.
`de-luce`	De Luce	Starší volba astrologů, vzácná.
`jn-bhasin`	JN Bhasin	Specifická škola, vzácná.
`true-citra`	True Chitra Paksha	Spika pevně na 0° Vah. Od Lahiri se liší o 0.01°, takže ji berte jen tehdy, když potřebujete právě ukotvení ke hvězdě.
`djwhal-khul`	Djwhal Khul	Teosofická škola, vzácná. Největší odchylka v tabulce.

Hlavní školy se liší málo: Lahiri, True Chitra a KP se drží v rozmezí 0.1°, Fagan/Bradley, JN Bhasin, Yukteshwar a Raman do 1.45°. Stranou stojí De Luce (3.96° od Lahiri) a Djwhal Khul (3.82°), u nichž se pozice blízko hranice znamení už přesouvá do sousedního znamení. Měřeno 2026-08-18 na Měsíci jedné mapy; u technik založených na stupních (pozice v nakshatře, Argala) je rozdíl vidět i v rámci 0.1°.

Sidereal, nebo tropical? Co API vrací?

Védské endpointy ve výchozím stavu vracejí siderické pozice (zvěrokruh ukotvený ke hvězdám, s aplikovanou ayanamshou). Západní endpointy (/v1/chart, /v1/synastry) vracejí tropické pozice (zvěrokruh ukotvený k bodu rovnodennosti).

Tropickou védskou astrologii (vzácný edge case, který navrhují Sanjay Rath a Ernst Wilhelm) API nevrací: všechny védské endpointy počítají siderickě a zodiacType v těle požadavku ignorují. Tropické pozice dává západní větev (/v1/chart, /v1/synastry) a zodiacType: "sidereal" ji přepne na siderický zvěrokruh se stejnou ayanamshou.

Kterou školu kdy použít?

Škola	Region / publikum	Silná stránka
Parashara (BPHS)	Celý védský svět - univerzální základ	Nejúplnější korpus technik; vždy začněte tady
Jaimini	Tamil Nadu + pokročilí praktici	Predikce založené na karakách; životní témata řízená AK
Lal Kitab	Paňdžáb + severní Indie	Unikátní nápravná opatření (upaye), specifika Manglik
KP (Krishnamurti)	Tamil Nadu + Ándhrapradéš	Sub-lord theory, přesnost v načasování událostí

Pratyangira, AstroSage a další velká API nabízejí převážně Parasharu. AstroWay pokrývá všechny čtyři přes samostatné skupiny endpointů.

Ashtakoot, nebo Dashakoota: pro jaký trh?

	Ashtakoot	Dashakoota
Region	Severní/střední Indie, Pákistán, Nepál	Jižní Indie (Tamil Nadu, Karnataka, Kerala)
Škála	max. 36 bodů	10 kut (faktorů)
Složky	Varna + Vashya + Tara + Yoni + Graha Maitri + Gana + Bhakoot + Nadi	Dina + Gana + Mahendra + Stri-Dirgha + Yoni + Rashi + Rashi-adhipathi + Vashya + Rajju + Vedha
API	`/v1/vedic/compatibility/ashtakoot`	`/v1/vedic/compatibility/dashakoota`

Pokud dohazovač obsluhuje celou Indii, volejte /v1/vedic/compatibility/full a dostanete obojí + Manglik + Bhrigu.

Mangal Dosha: proč na ní záleží?

Mangal Dosha = Mars v 1./2./4./7./8./12. domě od Lagny, Měsíce nebo Venuše (různé školy to vykládají různě). V Indii je to deal-breaker pro sňatek: pokud mají oba partneři afliktovaný Mars bez kompenzace, tradiční astrolog nedá zelenou bez upayí (nápravných opatření) nebo kompenzujících faktorů.

API endpoint: /v1/vedic/compatibility/manglik-check - vrací { chart1: { manglik: true/false, severity, factors }, chart2: ..., compensation: ... }.

D9 (Navamsha): proč je to nejdůležitější varga?

D9 = každé znamení rozdělené na 9 dílů = podrobná mapa na “úrovni duše”. Ve védské astrologii se používá pro:

Predikce manželství: Venuše + vládce 7. domu v D9 ukazují skutečnou povahu manželského života
Sílu planet: planeta silná v D1, ale slabá v D9 = “slibuje, ale nedoručí”
Vargottama: planeta ve stejném znamení v D1 i D9 = zvláštní síla

API: /v1/vedic/vargas vrací všech 16 dělení v jednom volání; pro funkce kolem manželství a vztahů se soustřeďte na D9.

Proč je čas narození kritický? Co dělat, když ho neznáme?

Védská astrologie je velmi citlivá na čas:

Lagna (ascendent) se mění zhruba každé ~2 hodiny: posune se CELÁ mapa
Nakshatra Měsíce se mění každých 6–8 hodin
Dasha balance (počáteční období) závisí na pozici Měsíce v nakshatře

Pokud přesný čas neznáte:

Sunrise chart: jako aproximaci použijte čas východu Slunce v místě narození. Slunce pak stojí na ascendentu, takže Lagna zhruba odpovídá znamení Slunce; někteří védští astrologové považují sunrise charts za platné pro prognózu obecných tendencí
Rektifikace: zavolejte /v1/rectification se 2-3 známými životními událostmi (sňatek, dítě, změna práce) - API vrátí pravděpodobné okno času narození
Upozornění pro uživatele: sdělte, že výsledky s neznámým časem jsou aproximace, ne přesná mapa

Jaké systémy domů se používají?

Védská astrologie tradičně používá domy Whole Sign (celé znamení = jeden dům). Západní astrologie Placidus / Koch / Equal atd.

Výchozí systém AstroWay pro védské endpointy je Whole Sign. Pro KP endpointy Placidus (konvence KP). Pokud potřebujete jiný, předejte parametr houseSystem: whole-sign, placidus, koch, equal, porphyry.

Dá se kombinovat védská a západní astrologie v jedné aplikaci?

Ano, a pro publikum z více tradic je to dokonce doporučené. Architektura:

Natální mapa se počítá jednou: západní i védské endpointy sdílejí stejný vstup (date/time/lat/lon)
Přidejte do UI přepínač “Western view” / “Vedic view”
Védské měsíční znamení (rashi) se často plete se západním slunečním znamením: upozorněte uživatele na rozdíl
Kompatibilita: můžete ukázat OBOJÍ, západní synastrii i védský Ashtakoot současně

API endpoint /v1/compat/astro-vedic to dělá automaticky - most mezi západní synastrií a védským Ashtakootem.

Jaké efemeridy se používají? Jak přesné jsou?

Swiss Ephemeris (LGPL) - stejné jako v Solar Fire, Kepler, Astro Gold, Janus, AstroSeek. Přesnost:

Pozice planet: ±1 úhlová vteřina vůči efemeridám NASA JPL
Hroty domů: ±1 úhlová minuta
Ayanamsha: tabulka Lahiri křížově ověřená proti oficiálním tabulkám indické vlády

Védsky specifické výpočty (pozice v nakshatře, Vimshottari balance, vargy) jsou křížově ověřené proti PyJHora (de facto referenční implementace v Pythonu); kde se liší, jsou rozdíly < 0.01°. Report rozdílů je v docs/AUDIT-TRAIL.md v repozitáři.

Můžu výsledky cachovat? Jak?

Ano, většina védských endpointů je deterministická pro stejný vstup mapy. Stabilní klíč cache: hash(date + time + lat + lon + ayanamsa + endpoint).

API také nabízí hlavičku X-Idempotency-Key - pětiminutovou cache na straně api-calc. Při cache hit se kredity neodečítají.

Jak jsou lokalizované texty v odpovědích?

Védské endpointy, které vracejí interpretace (popisy jóg, významy dosh, důvody muhurtu), přijímají parametr lang. Podpora: 20 jazyků (T0 - uk/en/de/ru ručně; T1 - pl/es/pt/hi/fr/ko AI Beta; T2/T3 - plánované). Podrobnosti: /languages/.

Pokud endpoint vrací číselná data (stupně, data, indexy znamení), jsou jazykově neutrální. Textová pole (note, meaning, manifestation) jsou lokalizovaná.

Co dělat se stavem YELLOW?

YELLOW = endpoint funguje, ale má jednu ze tří vlastností:

Škola jediného autora (Lal Kitab, KP): chybí křížové ověření s jinými školami, protože žádné neexistují
Založený na skóre nebo heuristice (compatibility 0-100, breakup-timing): číselné hodnocení je ze své podstaty subjektivní
Vnitřní limit přesnosti (rectification, Bhrigu match): algoritmus má vlastní spodní hranici přesnosti

Pro konkrétní endpoint se podívejte do docs/AUDIT-TRAIL.md - najdete tam, proč je YELLOW a zda existuje cesta ke GREEN. U většiny ne (jde o vnitřní limit), a to je poctivé upozornění pro integrátora.