रेक्टिफिकेशन एपीआई: विकासकर्ताओं के लिए जन्म समय की सुधार

Б्यादातर ज्योतिष उपयोगकर्ता जन्म तिथि जानते हैं, लेकिन सटीक समय नहीं जानते। 30 मिनट का अंतर असेंडेंट को 5+ डिग्री तक बदल सकता है - और यह घरों और पहलुओं की स्थिति को बदल देता है। गंभीर ज्योतिष कार्य के लिए यह महत्वपूर्ण है।

ज्योतिषियों द्वारा इसे ठीक करने की तकनीक रेक्टिफिकेशन कहलाती है - ज्ञात जीवन घटनाओं से संभावित जन्म समय की पुनर्प्राप्ति। पारंपरिक रूप से यह घंटों का हाथ से काम होता है। AstroWay दो एल्गोरिदमिक एन्डपॉइंट्स प्रदान करता है, जो इसे स्वचालित करते हैं।

इस पोस्ट में - कब रेक्टिफिकेशन लागू करना है, एल्गोरिदम कैसे काम करते हैं और इसे अपने एप्लिकेशन में कैसे इंटीग्रेट करना है।

रेक्टिफिकेशन - यह जन्म समय की सुधार है। तू अनुमानित समय (जैसे, “सुबह” या “लगभग 14:00”) से शुरू करता है और इसे संकुचित करता है, उपयोग करते हुए:

• महत्वपूर्ण जीवन घटनाएँ (विवाह, बच्चे, करियर परिवर्तन, मृत्यु)
• शारीरिक विशेषताएँ (क्लासिक ज्योतिष असेंडेंट संकेत को शरीर प्रकारों से जोड़ता है)
• जन्म के समय ग्रहों की कोणीय स्थितियाँ

आउटपुट - सटीक जन्म समय, आमतौर पर वास्तविक समय से ±5 मिनट के भीतर।

क्लासिक विधि, जो हर्मेस ट्रिस्मेज़िस्ट को दी गई है। यह जन्म के समय चंद्रमा की स्थिति और गर्भाधान के समय असेंडेंट/डिसेंडेंट के बीच संबंध का उपयोग करती है (~9 महीने पहले)।

यह कैसे काम करता है:

1. अनुमानित जन्म तिथि लेते हैं
2. गर्भाधान की तिथियों की सीमा (260–290 दिन पहले) की गणना करते हैं
3. प्रत्येक संभावित गर्भाधान तिथि के लिए जांचते हैं कि जन्म के समय चंद्रमा की स्थिति गर्भाधान के समय असेंडेंट/डिसेंडेंट से मेल खाती है या नहीं
4. फिट के आधार पर क्रमबद्ध संभावित जन्म समयों की सूची लौटाते हैं

तेज़, लेकिन कम सटीक। व्यापक विंडो को संकुचित करने के लिए अच्छा (उदाहरण के लिए, “सुबह” → 2 घंटे की विंडो)।

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. सीमा के भीतर संभावित जन्म समय उत्पन्न करता है (आमतौर पर 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}`);

रेक्टिफिकेशन मूल्यवान है:

• उन एप्लिकेशनों के साथ जिनके उपयोगकर्ता समय नहीं जानते: रेक्टिफिकेशन को प्रीमियम फीचर के रूप में पेश करो
• ज्योतिषी के पेशेवर टूल्स: प्रत्येक क्लाइंट पर हाथ से काम के घंटे बचाता है
• HD एप्लिकेशन्स: Human Design समय के प्रति बहुत संवेदनशील है; रेक्टिफिकेशन सटीकता को काफी बढ़ाता है
• शोध एप्लिकेशन्स: ऐतिहासिक चार्ट को वैध करने के लिए जहाँ समय रिकॉर्ड असटीक हैं

अप्रयुक्त:

• उन एप्लिकेशनों के लिए जहाँ उपयोगकर्ता पहले से ±5 मिनट की सटीकता से समय जानते हैं (कोई लाभ नहीं)
• सामान्य दैनिक राशिफल एप्लिकेशनों के लिए, जहाँ समय की सटीकता आउटपुट को प्रभावित नहीं करती (दैनिक सूर्य संकेत को इसकी आवश्यकता नहीं)

• Trutine: 250 क्रेडिट: ~1–2 सेकंड प्रति अनुरोध
• पूर्ण रेक्टिफिकेशन: 500 क्रेडिट: अधिकतम 120 सेकंड

ये API के सबसे भारी एन्डपॉइंट्स हैं। यदि तू रेक्टिफिकेशन को फीचर के रूप में पेश करता है - उसी अनुसार मूल्य निर्धारण कर: यह प्रीमियम ऑपरेशन है, जो उच्च सब्सक्रिप्शन टैरिफ या एकबारगी खरीद को उचित ठहराता है।

बजट योजना:

• 100 रेक्टिफिकेशन प्रति माह: ~50 000 क्रेडिट = Pro प्लान ($59) अन्य कॉल्स के लिए अतिरिक्त के साथ
• 1 000 रेक्टिफिकेशन प्रति माह: 500 000 क्रेडिट = Enterprise

रेक्टिफिकेशन समय लेता है। UI को चाहिए:

• असिंक्रोनस प्रोसेसिंग: अनुरोध को ब्लॉक मत करो; इसे कतार में रखो, प्रगति दिखाओ
• प्रोग्रेस इंडिकेटर: पूर्ण एन्डपॉइंट 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 का एल्गोरिदम सापेक्ष सटीकता पर केंद्रित है - विंडो को संकुचित करता है, लेकिन आउटपुट हमेशा “सबसे अच्छा उम्मीदवार” के रूप में प्रस्तुत किया जाता है, न कि गारंटीकृत सत्य के रूप में। हमेशा उपयोगकर्ताओं को confidence-स्कोर दिखाओ और यदि उनके पास बेहतर जानकारी हो तो पुनः परिभाषित करने की सुविधा दो।

एल्गोरिदम पैटर्न खोज होते हैं। एक अनुभवी ज्योतिषी संदर्भ को ध्यान में रखता है, जिसे कोड करना कठिन है: “क्या शादी जल्दबाजी में हुई?” “क्या करियर परिवर्तन स्वैच्छिक था?” उच्च दांव वाले चार्ट के लिए संयोजन करो:

1. एल्गोरिदमिक रेक्टिफिकेशन: विंडो को संकुचित करने के लिए
2. ज्योतिषी द्वारा मैनुअल रिव्यू: अंतिम सटीकता के लिए

तू अपना एप्लिकेशन इसे प्रीमियम कंसल्टेशन के रूप में पेश कर सकता है।

• API reference: rectification और rectification/trutine एन्डपॉइंट्स खोजो
• Тарифи: योजना के अनुसार क्रेडिट में लागत
• Швидкий старт: API कुंजी प्राप्त करो