Geçiş Haritası API
Herhangi bir hedef tarihte gökyüzünün anlık görüntüsünü alın ve bunu bir kişinin doğal ev çerçevesine tek bir POST isteğiyle yerleştirin. Geçen gezegenler, düştükleri doğal ev kısımları, geçen cisimler arasındaki yön ızgarası, paraleller ve antiskiler - İsviçre Efemeris hassasiyeti, JSON çıktısı.
Geçiş Haritası API
Geçiş uç noktası, bir kişinin doğal verilerini - doğum tarihi, saat, UTC ofseti, enlem, boylam ve ev sistemi - ve ayrı bir hedef an alır. Bu hedef tarihi ve saatini bir Julian gününe dönüştürür, her geçen cismin jeosantrik boylamını, enlemini ve hızını İsviçre Efemeris motorundan ister ve bu konumları doğal konumdan türetilmiş evlere yerleştirir. Yanıt, geçen gezegenleri işaretleri ve ev yerleşimleriyle, doğal ev kısımlarını ve geçen cisimler arasında hesaplanan tam yön ızgarasını, her biri uygulanan veya ayrılmış bayraklarla ve kesin orbs ile birlikte içerir. Ayrıca, deklinasyon ve güneş eksenli çalışma için paralel ve antiski (ayna noktası) yönlerini de döndürür. Geri hareketli hareket, cisim hızından bayraklanır, böylece hangi geçişlerin istenen anda doğrudan, durağan veya geriye doğru hareket ettiğini görebilirsiniz.
POST/v1/transits
curl -X POST https://api.astroway.info/v1/transits \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"date": "1990-05-15",
"time": "14:30:00",
"timezoneOffset": 3,
"latitude": 50.45,
"longitude": 30.52,
"transitDate": "2026-06-15",
"transitTime": "12:00:00",
"transitTzOffset": 3
}'{
"ok": true,
"data": {
"input": {},
"julianDay": 2461206.875,
"planets": [
{
"name": "Sun",
"longitude": 84.29,
"sign": "Gemini",
"house": 11
}
],
"houses": {
"ascendant": 160.4,
"mc": 70.1,
"cusps": [
"…"
]
},
"aspects": [
{
"planet1": "Sun",
"planet2": "Moon",
"type": "conjunction",
"orb": 1.2,
"applying": true
}
],
"parallelAspects": [
"…"
],
"antiscia": [
"…"
]
}
}Parameters
| name | type | Required | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | yes | Birth date. |
| time | string (HH:MM:SS) | yes | Local clock time at birth. |
| timezoneOffset | number (hours) | yes | UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones. |
| latitude | number | yes | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | yes | Birth-place longitude, decimal degrees (east positive). |
| transitDate | string (YYYY-MM-DD) | yes | Required target date for the transit snapshot (YYYY-MM-DD). |
| transitTime | string (HH:MM:SS) | no | Optional clock time of the transit moment (HH:MM:SS). |
| transitTzOffset | number (hours) | no | Optional UTC offset for the transit moment, in hours. |
When to use it
Belirli bir günde bir kişinin haritasının üzerinde duran tüm gökyüzünü istediğinizde kullanın - günlük geçişler widget'i, hava durumu tarzı 'şimdi tepede ne var' paneli, veya mevcut astro iklimi açıklamadan önce bir AI ajanının okuduğu ham çerçeve. Çünkü, doğal-natal temasların özenle seçilmiş listesi yerine, doğal ev çerçevesi üzerindeki geçiş haritasını döndürür, bu yüzden yapısal anlık görüntüyü kendiniz istediğinizde doğru seçimdir. Bunun yerine, bir tarih aralığı boyunca zamanlanmış geçiş-doğal temas vuruşlarını - kesin tarihler, geçişler, durağan noktalar - isterseniz, bu zamanlama işi için inşa edilmiş olan geçiş-takvim uç noktasına başvurun. İkisini birleştirin: bu uç nokta anlık harita için, takvim ileriye bakmalı olay listesi için.
Notes
Kapsam hakkında net olun: bu, önceden filtrelenmiş geçiş-doğal yön listesi yerine, doğal ev çerçevesi üzerine yerleştirilmiş geçiş haritasını döndürür. Yön ızgarası, geçen cisimler arasında hesaplanır, geçiş ve doğal noktalar arasında değil. Bir tarih aralığı boyunca doğal-natal zamanlaması için /transit-calendar kullanın. Evler seçtiğiniz doğal sistemini takip eder; tropik zodyak ve İsviçre Efemeris boyunca.
Try the Geçiş Haritası API
Grab a key and make your first call in under a minute.