飛星 (玄空飛星)

玄空飛星は、人ではなく建物の盤を作る風水の流派です。必要な情報は 2 つで、どちらも必須です: 建物に入居した時期の運 (period) と、建物が向いている方位です。この 2 つから、9 つのセクターそれぞれに 3 つの数字が導かれます。

各宮の 3 つの星

星	中文	読み取る対象
山の星	山星	人、健康、人間関係
運の星	運星	建物が属する時代
向の星	向星	財、機会、動き

星の数字とその飛泊は厳密な算術です。特定の部屋で数字の組み合わせが何を意味するかは解釈の伝統に属し、その伝統には複数の流派があります。レスポンスではこの 2 つが分けられており、計算がどこで終わるかは notes に記載されています。

エンドポイント

エンドポイント	クレジット	返す内容
`POST /v1/chinese/feng-shui/flying-star`	10	建物の命盤: 九宮、盤のタイプ、特殊な格局
`POST /v1/chinese/feng-shui/annual-stars`	10	年の飛星と年の凶殺、オプションで月のレイヤー

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 }'

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

方位は真北から時計回りの角度 (facing: 180) で指定するか、二十四山のいずれかの名前で指定できます: コード (S2)、ピンイン (Wu)、または漢字 (午)。運も同様に、数字 (period: 8) か入居日 (occupiedDate) で指定できます。後者の場合、年は固定の 2 月 4 日ではなく立春の正確な時刻から数えます。

盤のタイプ

正統的な配置は 4 つあり、レスポンスは該当するものの名前を返します:

id	中文	読み方
`wang-shan-wang-shui`	旺山旺水	最も吉: 人は後ろに、財は前に
`shang-shan-xia-shui`	上山下水	逆の配置。まさにここで実践者は外の地形を尋ねます
`double-facing`	雙星到向	両方の星が前に: 財には良く、後ろに支えが必要
`double-sitting`	雙星到坐	両方が後ろに: 人には良く、前に水が必要

何を、何で検証したか

星の飛泊の規則は、正しく説明されるより誤って説明されることのほうが多いものです。星を順飛させるか逆飛させるかを決めるのは、建物が向いている山の陰陽ではなく、その星自身の卦のセクターで同じ順番の位置にある山の陰陽です。

素朴な読み方では、公開されている八運の盤 24 枚のうち 6 枚しか再現できず、18 枚で失敗します。1、2 回の確認では見逃されかねないため、テストには公開されている全セットを入れています: 24 盤、9 宮、3 星、648 個の数字がすべて一致します。

五黄星には自分の卦がないため、運星の陰陽を借ります。広く流布しているもう 1 つの説明 (“5 が来た宮の陰陽”) は同じ規則です: 5 は常に洛書の数が 10 − period の宮に入り、その数は常に運と偶奇が一致します。これは注意書きとして残したのではなく、9 つの運すべてについて証明済みです。

年の飛星と凶殺

POST /v1/chinese/feng-shui/annual-stars は 9 つの年の飛星と、4〜5 つの年の凶殺を返します。実際に対策を取ろうとする人にとって、両者の違いは重要です:

太歳 (太歲) と 歳破 (歲破) は、それぞれ 1 つの山、15° です。
三殺 (三煞) はセクター全体、45° です。
五黄 (五黃) と 二黒 (二黑) は年盤のセクターです。

2026 年について、レスポンスは五黄を南、太歳を S2 (午)、歳破を N2、三殺を北に置き、公開されている暦と一致します。この 4 つの値はテストで固定されています。

ここでの年は太陽年で、立春に始まります。1 月の日付は前年に属します。だからこそデフォルト値を補うことはせず、year も date もなければ 400 を返します。