Stelle Volanti (玄空飛星)

Xuan Kong Fei Xing (玄空飛星) è la scuola di feng shui che costruisce la carta non per una persona, ma per un edificio. Bastano due dati, ed entrambi sono obbligatori: il periodo in cui l’edificio è stato occupato e la direzione verso cui è rivolto. Da questi si ricavano tre numeri per ciascuno dei nove settori.

Tre stelle in ogni palazzo

Stella	中文	Cosa si legge
Della montagna	山星	Persone, salute, relazioni
Del periodo	運星	L’epoca a cui appartiene l’edificio
Della facciata	向星	Denaro, opportunità, movimento

Il numero di una stella e il suo volo sono aritmetica esatta. Che cosa significhi una coppia di numeri in una determinata stanza, invece, è materia di tradizione interpretativa, e le scuole sono più di una. Nella risposta le due metà sono separate, e notes dice dove finisce il calcolo.

Endpoint

Endpoint	Crediti	Cosa restituisce
POST /v1/chinese/feng-shui/flying-star	10	Il tema natale dell’edificio: nove palazzi, tipo di carta, configurazioni particolari
POST /v1/chinese/feng-shui/annual-stars	10	Stelle annuali e afflizioni dell’anno, con un livello mensile opzionale

Attenzione

Il periodo non ha un valore predefinito. Senza period o occupiedDate la richiesta restituisce 400. Un edificio occupato nel 1998 appartiene al periodo 7, e una carta del periodo 9 presentata con sicurezza sarebbe per lui semplicemente una risposta sbagliata dall’aspetto corretto.

Esempio

cURL

curl -X POST https://api.astroway.info/v1/chinese/feng-shui/flying-star \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "period": 8, "facing": 180, "year": 2026 }'

Node

const res = await fetch('https://api.astroway.info/v1/chinese/feng-shui/flying-star', {
  method: 'POST',
  headers: { 'X-Api-Key': process.env.ASTROWAY_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({ occupiedDate: '2011-06-01', facingMountain: 'S2' }),
});
const { data } = await res.json();
console.log(data.chartType.id, data.palaces.find((p) => p.palace === 'S').pair);

La direzione si può indicare in gradi in senso orario dal nord vero (facing: 180) oppure con il nome di una delle 24 montagne: il codice (S2), il pinyin (Wu) o il carattere (午). Lo stesso vale per il periodo: un numero (period: 8) oppure la data di insediamento (occupiedDate), e in quel caso l’anno si conta dal momento esatto del Lichun, non da un 4 febbraio fisso.

Tipo di carta

Quattro configurazioni canoniche, e la risposta indica quella che risulta:

id	中文	Lettura
wang-shan-wang-shui	旺山旺水	La più favorevole: persone dietro, denaro davanti
shang-shan-xia-shui	上山下水	Invertita; è proprio qui che il praticante chiede com’è il paesaggio esterno
double-facing	雙星到向	Entrambe le stelle davanti: buona per il denaro, serve un sostegno dietro
double-sitting	雙星到坐	Entrambe dietro: buona per le persone, serve acqua davanti

Cosa abbiamo verificato, e con che cosa

La regola del volo delle stelle viene formulata in modo sbagliato più spesso che in modo corretto. A mandare una stella in avanti o all’indietro non è la polarità della montagna verso cui è rivolto l’edificio, ma la polarità della montagna nella stessa posizione ordinale all’interno del settore del trigramma proprio della stella.

La lettura ingenua riproduce 6 delle 24 carte pubblicate del periodo 8 e sbaglia le altre 18. Uno o due controlli l’avrebbero lasciata passare, per questo i test contengono l’intero set pubblicato: 24 carte, 9 palazzi, 3 stelle, 648 numeri, tutti coincidenti.

La stella 5 non ha un trigramma proprio e prende in prestito la polarità della stella del periodo. L’altra versione diffusa (“la polarità del palazzo da cui è arrivata la 5”) è la stessa versione: la 5 finisce sempre nel palazzo con il numero Lo Shu 10 − periodo, che ha sempre la stessa parità del periodo. Questo è dimostrato per tutti e nove i periodi, non lasciato come avvertenza.

Nota

替卦 (stelle sostitutive) non sono implementate, per scelta. Alcune scuole le applicano quando la misurazione cade vicino al confine di una montagna. Cambiano la carta, e le scuole non concordano sulle condizioni. Invece di scegliere in silenzio, la risposta avvisa: se la tua misurazione è a meno di 1.5° dal confine, warnings riporta la distanza e la montagna vicina.

Stelle annuali e afflizioni

POST /v1/chinese/feng-shui/annual-stars restituisce le nove stelle annuali e le quattro o cinque afflizioni dell’anno. La differenza tra loro conta per chi intende agire:

• Tai Sui (太歲) e Sui Po (歲破) occupano una montagna ciascuno, 15° l’una.
• San Sha (三煞) è un intero settore, 45°.
• Il cinque giallo (五黃) e il due nero (二黑) sono settori della carta annuale.

Per il 2026 la risposta colloca il cinque giallo a sud, Tai Sui in S2 (午), Sui Po in N2 e San Sha a nord, in accordo con gli almanacchi pubblicati; questi quattro valori sono fissati da un test.

L’anno qui è solare e inizia con il Lichun. Una data di gennaio appartiene all’anno precedente, ed è proprio per questo che non viene sostituito nulla per default: senza year o date si ottiene 400.

Cosa c’è accanto

Il resto della superficie feng shui esisteva già nell’API e resta dov’è: POST /v1/chinese/feng-shui/kua (numero Kua), /lucky-directions (le otto direzioni personali) e /bagua (la mappa delle nove aree della vita).