API التصحيح: تصحيح وقت الميلاد للمطورين

يعرف معظم مستخدمي علم الفلك تاريخ ميلادهم، لكنهم لا يعرفون الوقت الدقيق. يمكن أن يؤدي فرق 30 دقيقة إلى تحريك الطالع بأكثر من 5 درجات - وهذا يغير مواقع البيوت والجوانب. هذا أمر بالغ الأهمية للعمل الفلكي الجاد.

تُعرف التقنية التي يستخدمها المنجمون لتصحيح ذلك باسم التصحيح الفلكي (Rectification) - استعادة وقت الميلاد المحتمل من أحداث الحياة المعروفة. تقليديًا، يستغرق هذا ساعات من العمل اليدوي. يوفر AstroWay نقطتي نهاية خوارزميتين لأتمتة هذه العملية.

في هذا المنشور - متى تطبق التصحيح الفلكي، وكيف تعمل الخوارزميات، وكيف تدمجها في تطبيقك.

التصحيح الفلكي هو تصحيح وقت الميلاد. تبدأ بوقت تقريبي (مثل “الصباح” أو “حوالي الساعة 2:00 ظهرًا”) وتضيقه باستخدام:

• أحداث الحياة الهامة (الزواج، الأطفال، التغيير المهني، الوفيات)
• الخصائص الجسدية (يربط علم الفلك الكلاسيكي علامة الطالع بأنواع الأجسام)
• المواقع الزاوية للكواكب عند الولادة

والنتيجة هي وقت ميلاد مصحح، عادةً في حدود ±5 دقائق من الوقت الفعلي.

طريقة كلاسيكية تُنسب إلى هرمس الهرامسة. تستخدم العلاقة بين موقع القمر لحظة الميلاد والطالع / الغارب لحظة الحمل (~9 أشهر قبل ذلك).

كيف يعمل هذا:

1. نأخذ تاريخ ميلاد تقريبي
2. نحسب نطاق تواريخ الحمل (260-290 يومًا قبل ذلك)
3. لكل تاريخ حمل مرشح، نتحقق مما إذا كان موقع القمر عند الميلاد يتوافق مع الطالع / الغارب لحظة الحمل
4. نعيد قائمة بأوقات الميلاد المرشحة، مرتبة حسب “التوافق” (fit)

سريع، ولكنه أقل دقة. جيد لتضييق نافذة واسعة (على سبيل المثال، “الصباح” ← نافذة ساعتين).

const result = await client.rectification.trutine({
  date: '1990-07-14',
  time: '14:30:00',
  timezoneOffset: 3,
  latitude: 50.4501,
  longitude: 30.5234,
});

console.log(`Suggested ascendant: ${result.suggestedAsc.toFixed(2)}°`);
console.log(`Moon above the horizon at conception: ${result.moonAboveHorizon}`);

نهج خوارزمي يعتمد على عدة أحداث حياتية. هذا خيار مكثف (يصل إلى 120 ثانية لكل طلب).

المدخلات:

• وقت ميلاد تقريبي (نطاق)
• قائمة بأحداث الحياة مع التواريخ والأنواع
• اختياري: وصف جسدي

الخوارزمية:

1. تولد أوقات ميلاد مرشحة ضمن النطاق (عادةً بزيادات دقيقة واحدة)
2. تحسب الخريطة الفلكية لكل مرشح
3. تسجل كل مرشح بناءً على مدى توافق الأحداث مع الأنماط الفلكية المتوقعة (التقدمات، التوجيهات، العبورات)
4. تعيد أفضل المرشحين مع تقييمات الثقة

const result = await client.rectification.compute({
  baseInput: {
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.4501,
    longitude: 30.5234,
  },
  events: [
    // type picks which significators are checked; weight is 1-3 importance
    { date: '2015-06-20', type: 'marriage', description: 'married', weight: 3 },
    { date: '2018-03-12', type: 'child', description: 'first child', weight: 2 },
    { date: '2020-09-05', type: 'career', description: 'career change', weight: 2 },
  ],
  searchRangeMinutes: 120,
  stepMinutes: 5,
});

const best = result.candidates[0];
console.log(`Best candidate: ${best.timeFormatted}, score ${best.score.toFixed(2)}, ${result.count} candidates scored`);
console.log(`Candidates: ${result.candidates.length}`);

التصحيح الفلكي قيّم لـ:

• التطبيقات التي لا يعرف فيها المستخدمون الوقت: قدم التصحيح الفلكي كميزة مميزة (premium-feature)
• أدوات المنجمين المحترفين: يوفر ساعات من العمل اليدوي لكل عميل
• تطبيقات التصميم البشري (Human Design): التصميم البشري حساس جدًا للوقت؛ التصحيح الفلكي يحسن الدقة بشكل كبير
• التطبيقات البحثية: للتحقق من الخرائط التاريخية حيث تكون سجلات الوقت غير دقيقة

غير مفيد لـ:

• التطبيقات التي يعرف فيها المستخدم الوقت بدقة ±5 دقائق (لا توجد فائدة)
• تطبيقات الأبراج العادية حيث لا تؤثر دقة الوقت على المخرجات (علامة الشمس اليومية لا تتطلب ذلك)

• ميزان هرمس (Trutine): 250 رصيدًا: ~1-2 ثانية لكل طلب
• التصحيح الفلكي الكامل: 500 رصيد: يصل إلى 120 ثانية

هذه هي نقاط النهاية الأكثر كثافة في الـ API. إذا كنت تقدم التصحيح الفلكي كميزة - فضع تسعيرة مناسبة: إنها عملية مميزة تبرر سعر اشتراك أعلى أو عملية شراء لمرة واحدة.

تخطيط الميزانية:

• 100 تصحيح فلكي شهريًا: ~50,000 رصيد = خطة Pro (59 دولارًا) مع رصيد إضافي للمكالمات الأخرى
• 1,000 تصحيح فلكي شهريًا: 500,000 رصيد = Enterprise

يستغرق التصحيح الفلكي وقتًا. يجب أن تحتوي واجهة المستخدم على:

• معالجة غير متزامنة: لا تحظر الطلب؛ ضعه في قائمة الانتظار، واعرض التقدم
• مؤشر التقدم: تعمل نقطة النهاية الكاملة لمدة تصل إلى 120 ثانية؛ يحتاج المستخدم إلى ملاحظات
• عرض النتيجة: الوقت المصحح، مستوى الثقة، إمكانية إعادة التشغيل إذا كانت الأحداث غير دقيقة

async function handleRectify(input: RectifyInput) {
  setLoading(true);
  setStatus('Running rectification (this may take up to 2 minutes)...');

  try {
    const result = await client.rectification.compute(input);
    setResult(result);
    const best = result.candidates[0];
    setStatus(`Done. Refined time: ${best.timeFormatted} (score ${best.score.toFixed(2)} of ${result.count})`);
  } catch (err) {
    setStatus(`Error: ${err.message}`);
  } finally {
    setLoading(false);
  }
}

سير عمل التصحيح الفلكي النموذجي في التطبيق:

1. يدخل المستخدم بيانات الميلاد التقريبية + أحداث الحياة
2. يستدعي التطبيق أولاً /v1/rectification/trutine (رخيص، سريع) لتضييق النافذة
3. ثم يستدعي /v1/rectification (كامل) مع النافذة المصححة للدقة
4. يقوم التطبيق بتخزين النتيجة مؤقتًا ويستخدم الوقت المصحح لجميع الحسابات المستقبلية
5. يتم تمييز الاستدعاءات المستقبلية بـ “rectified from approximate”

يوفر هذا النهج المدمج ~750 رصيدًا للدورة الكاملة، ولكنه يوفر أفضل دقة.

لا يوفر التصحيح الفلكي دقة بنسبة 100% أبدًا. حتى المنجمون المحترفون يختلفون في تقديراتهم بـ 5-10 دقائق.

تركز خوارزمية AstroWay على الدقة النسبية - فهي تضيق النافذة، ولكن المخرجات تُقدم دائمًا على أنها “أفضل مرشح”، وليست حقيقة مضمونة. اعرض دائمًا للمستخدمين تقييم الثقة وامنحهم خيار التجاوز إذا كان لديهم معلومات أفضل.

الخوارزميات هي البحث عن الأنماط. يأخذ المنجم ذو الخبرة في الاعتبار السياق الذي يصعب ترميزه: “هل كان الزواج متسرعًا؟” “هل كان التغيير المهني طوعيًا؟” للخرائط ذات المخاطر العالية، ادمج:

1. التصحيح الفلكي الخوارزمي: لتضييق النافذة
2. المراجعة اليدوية من قبل منجم: للتوضيح النهائي

يمكن لتطبيقك أن يقدم هذا كاستشارة مميزة.

• مرجع الـ API: ابحث عن نقاط النهاية rectification و rectification/trutine
• الأسعار: التكلفة بالنقاط حسب الخطة
• البدء السريع: احصل على مفتاح الـ API الخاص بك