Düzeltilmiş API: Geliştiriciler için Doğum Zamanı Düzeltilmesi

Astroloji kullanıcılarının çoğu doğum tarihini bilir, ancak tam saati bilmez. 30 dakikalık bir fark, yükseleni 5+ derece kaydırabilir - ve bu, evlerin konumunu ve açıları değiştirir. Ciddi astroloji çalışmaları için bu önemlidir.

Astrologların bunu düzeltmek için kullandığı tekniğe rektifikasyon denir - bilinen yaşam olaylarından olası doğum saatinin yeniden hesaplanması. Geleneksel olarak bu, saatler süren manuel bir iştir. AstroWay, bunu otomatikleştiren iki algoritmik endpoint sunar.

Bu yazıda - rektifikasyonun ne zaman kullanılacağı, algoritmaların nasıl çalıştığı ve uygulamana nasıl entegre edileceği var.

Rektifikasyon, doğum saatinin düzeltilmesidir. Yaklaşık bir saatle başlarsın (örneğin “sabah” ya da “14:00 civarı”) ve şunları kullanarak daraltırsın:

• Önemli yaşam olayları (evlilik, çocuklar, kariyer değişikliği, ölümler)
• Fiziksel özellikler (klasik astroloji, yükselen burcu vücut tipleriyle eşleştirir)
• Doğum anındaki gezegenlerin açısal konumları

Çıktı, genellikle gerçek saatin ±5 dakikası içinde, hassaslaştırılmış bir doğum saatidir.

Hermes Trismegistus’a atfedilen klasik yöntem. Doğum anındaki Ay konumu ile gebe kalma anındaki (~9 ay önce) yükselen / alçalan arasındaki ilişkiyi kullanır.

Nasıl çalışır:

1. Yaklaşık doğum tarihini alırız
2. Gebe kalma tarih aralığını hesaplarız (260–290 gün önce)
3. Her aday gebe kalma tarihi için, doğumdaki Ay konumunun gebe kalma anındaki yükselen / alçalan ile eşleşip eşleşmediğini kontrol ederiz
4. Uyuma göre sıralanmış aday doğum saatleri listesini döndürürüz

Hızlıdır ama daha az hassastır. Geniş bir pencereyi daraltmak için iyidir (örneğin “sabah” → 2 saatlik pencere).

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

Birden fazla yaşam olayına dayanan algoritmik yaklaşım. Bu ağır varyanttır (istek başına 120 saniyeye kadar).

Girdi:

• Yaklaşık doğum saati (aralık)
• Tarihleri ve türleriyle yaşam olayları listesi
• Opsiyonel: fiziksel tanım

Algoritma:

1. Aralık içinde aday doğum saatleri üretir (genellikle 1 dakikalık adımlarla)
2. Her aday için doğum haritasını hesaplar
3. Olayların öngörülen astrolojik kalıplarla (progresyonlar, direksiyonlar, transitler) ne kadar eşleştiğine göre her birini puanlar
4. Güven skorlarıyla en iyi adayları döndürür

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

Rektifikasyon şunlar için değerlidir:

• Saati bilmeyen kullanıcılara sahip uygulamalar: rektifikasyonu premium bir özellik olarak sun
• Profesyonel astrolog araçları: her müşteri için saatlerce manuel işten tasarruf sağlar
• HD uygulamaları: Human Design saate çok duyarlıdır; rektifikasyon doğruluğu ciddi şekilde artırır
• Araştırma uygulamaları: saat kayıtlarının kesin olmadığı tarihsel haritaları doğrulamak için

Faydalı olmadığı durumlar:

• Kullanıcının saati zaten ±5 dk hassasiyetle bildiği uygulamalar (fayda yok)
• Saat hassasiyetinin çıktıyı etkilemediği gündelik burç uygulamaları (günlük sun sign buna ihtiyaç duymaz)

• Trutine: 250 kredi: istek başına ~1–2 saniye
• Tam rektifikasyon: 500 kredi: 120 saniyeye kadar

Bunlar API’deki en ağır endpoint’lerdir. Rektifikasyonu bir özellik olarak sunuyorsan - fiyatlandırmayı buna göre yap: bu, daha yüksek bir abonelik katmanını veya tek seferlik satın almayı haklı çıkaran premium bir işlemdir.

Bütçe planlaması:

• Ayda 100 rektifikasyon: ~50 000 kredi = Pro planı ($59) diğer çağrılar için payla birlikte
• Ayda 1 000 rektifikasyon: 500 000 kredi = Enterprise

Rektifikasyon zaman alır. UI şunları yapmalı:

• Asenkron işleme: isteği bloklama; kuyruğa al, ilerlemeyi göster
• İlerleme göstergesi: tam endpoint 120 saniyeye kadar çalışır; kullanıcının geri bildirime ihtiyacı var
• Sonuç gösterimi: hassaslaştırılmış saat, güven seviyesi, olaylar hatalıysa yeniden çalıştırma imkânı

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

Bir uygulamadaki tipik rektifikasyon akışı:

1. Kullanıcı yaklaşık doğum verilerini + yaşam olaylarını girer
2. Uygulama önce /v1/rectification/trutine çağırır (ucuz, hızlı) pencereyi daraltmak için
3. Sonra hassasiyet için daraltılmış pencereyle /v1/rectification (tam) çağırır
4. Uygulama sonucu önbelleğe alır ve hassaslaştırılmış saati gelecekteki tüm hesaplamalar için kullanır
5. Gelecekteki çağrılar “rectified from approximate” etiketiyle işaretlenir

Bu birleşik yaklaşım - tam döngü başına ~750 kredi, ancak en iyi hassasiyeti verir.

Rektifikasyon asla %100 doğruluk vermez. Profesyonel astrologlar bile tahminlerinde 5–10 dakika farklılaşır.

AstroWay algoritması göreli doğruluğa odaklanır - pencereyi daraltır, ancak çıktı her zaman garantili bir gerçek olarak değil, “en iyi aday” olarak konumlandırılır. Kullanıcılara her zaman güven skorunu göster ve daha iyi bilgisi varsa yeniden tanımlama imkânı ver.

Algoritmalar kalıp aramadır. Deneyimli bir astrolog, kodlanması zor olan bağlamı dikkate alır: “Evlilik aceleye mi getirilmişti?” “Kariyer değişikliği gönüllü müydü?” Yüksek önem taşıyan haritalar için şunları birleştir:

1. Algoritmik rektifikasyon: pencereyi daraltmak için
2. Astrolog tarafından manuel inceleme: nihai hassaslaştırma için

Uygulaman bunu premium bir danışmanlık olarak sunabilir.

• API referansı: rectification ve rectification/trutine endpoint’lerini bul
• Fiyatlandırma: plana göre kredi maliyeti
• Hızlı başlangıç: API anahtarını al