SkyMap API Documentation

კეთილი იყოს თქვენი მობრძანება SkyMap-ის ოფიციალურ დეველოპერის პორტალში. ჩვენი API გაძლევთ წვდომას მსოფლიოში ერთ-ერთ ყველაზე ზუსტ ასტროლოგიურ ძრავზე.

ყველა მოთხოვნა უნდა შეიცავდეს x-api-key ჰედერს (Header) ავტორიზაციისთვის.

გლობალური მოდიფიკატორები (Parameters):

ნებისმიერ ენდფოინტში შეგიძლიათ გამოიყენოთ შემდეგი Query პარამეტრები შედეგის დასაკონფიგურირებლად:

• ?fixed_stars=true - დააბრუნებს დამატებით 100+ ფიქსირებულ ვარსკვლავს (Galaxy/Universe პაკეტებისთვის).
  მაგალითი: https://skymap.ge/api/v1/natal?date=1990-01-01&time=12:00&lat=41.71&lon=44.78&fixed_stars=true
• ?fictitious=true - დააბრუნებს ფიქტიურ წერტილებს (Lilith, Selena, Vertex და ა.შ).
  მაგალითი: https://skymap.ge/api/v1/natal?date=1990-01-01&time=12:00&lat=41.71&lon=44.78&fictitious=true
• ?house_system=P - სახლების სისტემა (P=Placidus, K=Koch, W=Whole Sign, R=Regiomontanus, C=Campanus).
  მაგალითი: https://skymap.ge/api/v1/natal?date=1990-01-01&time=12:00&lat=41.71&lon=44.78&house_system=K
• ?mode=vedic - რეჟიმის შეცვლა. მხარდაჭერილია: standard, classic, vedic, draconic, uranian, cosmogram.
  მაგალითი: https://skymap.ge/api/v1/natal?date=1990-01-01&time=12:00&lat=41.71&lon=44.78&mode=vedic

curl -X GET "https://skymap.ge/api/v1/natal?date=1990-01-01&time=12:00&lat=41.71&lon=44.78" \
  -H "x-api-key: YOUR_API_KEY"

import requests

url = "https://skymap.ge/api/v1/natal"
params = {
    "date": "1990-01-01",
    "time": "12:00",
    "lat": 41.71,
    "lon": 44.78
}
headers = {"x-api-key": "YOUR_API_KEY"}

response = requests.get(url, headers=headers, params=params)
print(response.json())

const url = "https://skymap.ge/api/v1/natal?date=1990-01-01&time=12:00&lat=41.71&lon=44.78";

fetch(url, {
  method: "GET",
  headers: { "x-api-key": "YOUR_API_KEY" }
})
.then(response => response.json())
.then(data => console.log(data));

$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://skymap.ge/api/v1/natal?date=1990-01-01&time=12:00&lat=41.71&lon=44.78",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ["x-api-key: YOUR_API_KEY"],
]);
$response = curl_exec($curl);
echo $response;

Natal Chart

აბრუნებს ადამიანის ნატალურ რუკას (პლანეტების ზუსტი გრადუსები, სახლები, ასპექტები) მოცემული დროისთვის და ადგილისთვის.

Parameter	Description
date Req	ფორმატი: YYYY-MM-DD
time Req	ფორმატი: HH:MM
lat Req	განედი ათწილადში (მაგ: 41.7151)
lon Req	გრძედი ათწილადში (მაგ: 44.8271)
timezone Opt	სასაათო სარტყელი (ნაგულისხმევი: Asia/Tbilisi)

{
  "meta": { 
    "lunar_phase": "მესამე მეოთხედი",
    "lunar_day": 24
  },
  "planets": [
    {
      "id": "Sun",
      "name": "მზე",
      "sign": "კურო",
      "longitude": 54.321,
      "degree": 24,
      "minute": 19,
      "house": 9,
      "speed": 0.98,
      "is_retrograde": false
    }
  ],
  "houses": [ ... ],
  "aspects": [ ... ]
}

Transit Chart

აბრუნებს ტრანზიტულ რუკას მოცემული დროისთვის. იდეალურია ყოველდღიური ჰოროსკოპების ან მიმდინარე ასტროლოგიური მდგომარეობის შესამოწმებლად.

Parameter	Description
date Req	ტრანზიტის თარიღი (YYYY-MM-DD)
time Req	ტრანზიტის დრო (HH:MM)
lat Opt	ადგილის განედი (default: 41.7151)
lon Opt	ადგილის გრძედი (default: 44.8271)

{
  "meta": {
    "date": "2026-07-13",
    "time": "14:30"
  },
  "planets": [
    {
      "id": "Moon",
      "name": "მთვარე",
      "sign": "ლომი",
      "degree": 12,
      "minute": 5,
      "is_retrograde": false
    }
  ]
}

Synastry (Compatibility)

ადარებს 2 ადამიანის რუკას და პოულობს ორმხრივ ასპექტებს (შეერთება, ტრინი, კვადრატურა და ა.შ). იდეალურია თავსებადობის ალგორითმებისთვის.

Parameter	Description
p1_date, p1_time, p1_lat, p1_lon Req	პირველი ადამიანის მონაცემები
p2_date, p2_time, p2_lat, p2_lon Req	მეორე ადამიანის მონაცემები

{
  "synastry_aspects": [
    {
      "p1_planet": "მზე",
      "p1_planet_id": "Sun",
      "p2_planet": "მთვარე",
      "p2_planet_id": "Moon",
      "aspect": "შეერთება",
      "aspect_angle": 0,
      "orb": 2.4
    }
  ]
}

Composite Chart

კომპოზიტური (საერთო) რუკა თავსებადობის დინამიკის გასაანალიზებლად. *ამჟამად ხელმისაწვდომია მხოლოდ ძირითადი კალკულატორიდან, API პირდაპირ სინასტრიას აბრუნებს.*

Solar & Lunar Returns

ითვლის ზუსტ მომენტს, როდესაც მზე/მთვარე უბრუნდება ნატალურ პოზიციას და აბრუნებს წლის/თვის პროგნოზის რუკას.

Parameter	Description
date, time, lat, lon Req	ნატალური მონაცემები
target_year Req	Solar Return-ისთვის (მაგ: 2026)
target_date Req	Lunar Return-ისთვის მოძებნის უახლოეს დაბრუნებას

{
  "meta": { 
    "return_datetime_utc": "2026-05-15 13:45:00" 
  },
  "planets": [
    {
      "id": "Sun",
      "name": "მზე",
      "longitude": 54.321,
      "sign": "კურო"
    }
  ]
}

Progressions

მეორადი (Secondary), მესამეული (Tertiary) და მინორული (Minor) პროგრესიები პროგნოზირებისთვის.

Parameter	Description
date, time, lat, lon Req	ნატალური მონაცემები
target_date Req	ფორმატი YYYY-MM-DD
type Opt	URL-ში: `tertiary` ან `minor`

{
  "meta": {
    "progression_date_utc": "1990-02-05 12:00"
  },
  "planets": [ ... ]
}

Directions (Solar Arc)

პროგნოზირების მეთოდი სადაც ყველა პლანეტა გადაადგილდება მზის რკალის შესაბამისად.

Parameter	Description
date, time, lat, lon Req	ნატალური მონაცემები
target_date Req	ფორმატი YYYY-MM-DD

{
  "meta": {
    "target_date": "2026-01-01",
    "arc_degrees": 35.412
  },
  "planets": [
    {
      "id": "Sun",
      "longitude": 89.733,
      "sign": "ტყუპები"
    }
  ]
}

Profections

წლიური პროფექციები, სადაც ყოველ წელს რუკა ინაცვლებს 30 გრადუსით (1 ნიშნით).

Parameter	Description
date, time Req	ნატალური მონაცემები
target_date Req	ფორმატი YYYY-MM-DD

{
  "meta": { "target_date": "2026-05-10" },
  "profection_arc_degrees": 1080.0
}

Firdaria & Zodiacal Releasing

დროის მმართველობის ტრადიციული პერიოდები. *მხარდაჭერილია შიდა ფუნქციონალით, API ფორმატიზაცია მალე დაემატება.*

Harmonic Charts

ქმნის ჰარმონიულ რუკებს, სადაც ყველა პოზიცია მრავლდება არჩეულ რიცხვზე.

*გამოიყენეთ `/natal` ენდფოინტი და გაამრავლეთ longitude `harmonic_number`-ზე.*

Relocation Chart

აბრუნებს ახალ ლოკაციაზე გადათვლილ რუკას. უბრალოდ გაგზავნეთ ორიგინალი `date` და `time` ახალი `lat` და `lon` პარამეტრებით `/natal` ენდფოინტზე.

Astrocartography (ACG)

აბრუნებს ოთხივე კუთხის (ASC, MC, DSC, IC) გეოგრაფიულ კოორდინატებს მსოფლიო რუკაზე ხაზების დასახატად.

Parameter	Description
date, time Req	დაბადების დრო (UTC-ში კონვერტირდება)

{
  "acg_lines": [
    {
      "planet": "Sun",
      "line_type": "MC",
      "lon": -15.4,
      "lat": [80.0, -80.0]
    }
  ]
}

Aspect Grid & Midpoints

ასპექტების ბადე უკვე ბრუნდება `/natal` ენდფოინტის aspects მასივში. მიდპოინტები ითვლება პლანეტების longitude-ების გასაშუალედებით.

Formulas & Dignities

ითვლის პლანეტების სიძლიერეს (Cosmo Power), ჰარმონიას და ეთერულ ღირსებებს.

{
  "formulas": [
    {
      "planet": "მზე",
      "cosmo_power": 45,
      "cosmo_power_status": "Strong",
      "harmony": 12,
      "details": {
        "essential_dignities": ["domicile"],
        "house_power": 10
      }
    }
  ]
}

Retrogrades

აბრუნებს პლანეტების რეტროგრადულობის პერიოდებს კონკრეტული წლისთვის.

Parameter	Description
year Req	წელიწადი (მაგ: 2026)

{
  "retrogrades": {
    "Mercury": [
      { "start": "2026-02-26", "end": "2026-03-21" },
      { "start": "2026-06-29", "end": "2026-07-23" }
    ]
  }
}

Ephemeris

ყოველდღიური ეფემერიდები დროის მოცემული შუალედისთვის.

Parameter	Description
start_date Req	საწყისი თარიღი
end_date Req	საბოლოო თარიღი (მაქს. 1 წელი)
step_days Opt	ნაბიჯი დღეებში (default: 1)

{
  "ephemeris": [
    {
      "date": "2026-01-01",
      "positions": {
        "Sun": 280.5,
        "Moon": 15.2
      }
    }
  ]
}

Sabian Symbols

აბრუნებს საბიანურ სიმბოლოებს (ტექსტურ აღწერას) ნიშნისა და გრადუსის მიხედვით.

Parameter	Description
sign Req	ნიშნის ინდექსი 1-12 (1=Aries)
degree Req	გრადუსი 0-29

{
  "meta": { "sign": 1, "degree": 5 },
  "sabian_symbol": "კვადრატი, რომლის ერთ მხარესაც წითლად ანათებს..."
}

Void of Course

აბრუნებს უახლოეს პერიოდებს, როდესაც მთვარე კურსის გარეშეა.

Parameter	Description
date, time Req	საწყისი დრო
count Opt	პერიოდების რაოდენობა (ნაგულისხმევი: 3)

{
  "void_of_course_periods": [
    {
      "start_utc": "2026-07-15 14:20:00",
      "end_utc": "2026-07-15 18:30:00",
      "last_aspect": "Trine Sun",
      "sign_entry": "Virgo"
    }
  ]
}

Eclipses & Path

აბრუნებს დაბნელებების ჩამონათვალს ან კონკრეტული დაბნელების ტრაექტორიას.

{
  "eclipses": [
    {
      "date_utc": "2026-02-17",
      "type": "Annular Solar Eclipse",
      "jd_max": 2461094.5
    }
  ]
}