Estrelas Voadoras (玄空飛星)

Xuan Kong Fei Xing (玄空飛星) é uma escola de feng shui que constrói um mapa não para uma pessoa, mas para um edifício. Bastam duas coisas, e ambas são obrigatórias: o período em que o edifício foi ocupado e a direção para onde está virado. A partir delas derivam-se três números para cada um dos nove setores.

Três estrelas em cada palácio

Estrela	中文	O que se lê
Da montanha	山星	Pessoas, saúde, relações
Estrela do período	運星	A época a que o edifício pertence
Da fachada	向星	Dinheiro, oportunidades, movimento

O número de uma estrela e o seu voo são aritmética exata. O que significa um par de números numa divisão concreta já é uma tradição interpretativa, com mais do que uma escola. Na resposta, estas duas metades estão separadas, e notes indica onde termina o cálculo.

Endpoints

Endpoint	Créditos	O que devolve
POST /v1/chinese/feng-shui/flying-star	10	Mapa natal do edifício: nove palácios, tipo de mapa, padrões especiais
POST /v1/chinese/feng-shui/annual-stars	10	Estrelas anuais e aflições do ano, opcionalmente a camada mensal

Cuidado

O período não tem valor por omissão. Sem period ou occupiedDate, o pedido devolve 400. Um edifício ocupado em 1998 pertence ao período 7, e um mapa confiante do período 9 seria para ele simplesmente uma resposta errada com aspeto de certa.

Exemplo

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);

A direção pode ser indicada em graus no sentido dos ponteiros do relógio a partir do norte verdadeiro (facing: 180) ou pelo nome de uma das 24 montanhas: pelo código (S2), em pinyin (Wu) ou pelo carácter (午). O período também: por número (period: 8) ou pela data de ocupação (occupiedDate), e nesse caso o ano conta a partir do momento exato do Lichun, não de um 4 de fevereiro fixo.

Tipo de mapa

Quatro disposições canónicas, e a resposta indica qual delas saiu:

id	中文	Leitura
wang-shan-wang-shui	旺山旺水	A mais favorável: pessoas atrás, dinheiro à frente
shang-shan-xia-shui	上山下水	Invertida; é aqui que o praticante pergunta pela paisagem exterior
double-facing	雙星到向	Ambas as estrelas à frente: bom para o dinheiro, precisa de apoio atrás
double-sitting	雙星到坐	Ambas atrás: bom para as pessoas, precisa de água à frente

O que verificámos, e com quê

A regra do voo das estrelas é formulada mais vezes de forma errada do que certa. O que envia uma estrela para a frente ou para trás não é a polaridade da montanha para onde o edifício está virado, mas a polaridade da montanha na mesma posição ordinal no setor do trigrama da própria estrela.

A leitura ingénua reproduz 6 de 24 mapas publicados do período 8 e falha 18. Uma ou duas verificações deixá-la-iam passar, por isso os testes contêm todo o conjunto publicado: 24 mapas, 9 palácios, 3 estrelas, 648 números, e todos coincidem.

A estrela 5 não tem trigrama próprio e toma emprestada a polaridade da estrela do período. A outra versão comum (“a polaridade do palácio de onde veio o 5”) é a mesma versão: o 5 acaba sempre no palácio com o número Lo Shu 10 − período, e este tem sempre a paridade do período. Isto está provado para os nove períodos, e não deixado como ressalva.

Nota

替卦 (estrelas de substituição) não estão implementadas de propósito. Algumas escolas aplicam-nas quando a medição cai perto da fronteira de uma montanha. Isso altera o mapa, e as escolas não concordam quanto às condições. Em vez de uma escolha silenciosa, a resposta avisa: se a tua medição estiver a menos de 1.5° da fronteira, warnings terá a distância e a montanha vizinha.

Estrelas anuais e aflições

POST /v1/chinese/feng-shui/annual-stars dá as nove estrelas anuais e as quatro a cinco aflições do ano. A diferença entre elas importa para quem vai agir:

• Tai Sui (太歲) e Sui Po (歲破) ocupam uma montanha cada, 15° cada.
• San Sha (三煞) é um setor inteiro, 45°.
• Cinco Amarelo (五黃) e Dois Preto (二黑) são setores do mapa anual.

Para 2026, a resposta coloca o Cinco Amarelo a sul, o Tai Sui em S2 (午), o Sui Po em N2 e o San Sha a norte, o que coincide com os almanaques publicados; estes quatro valores estão fixados por um teste.

O ano aqui é solar e começa no Lichun. Uma data de janeiro pertence ao ano anterior, e é precisamente por isso que nada é assumido por omissão: sem year ou date, a resposta é 400.

O que há ao lado

O resto da superfície de feng shui já existia na API e continua no mesmo sítio: POST /v1/chinese/feng-shui/kua (número Kua), /lucky-directions (as oito direções pessoais) e /bagua (o mapa das nove áreas da vida).