Назад к документации

Астрокартография Паранс

Астрокартография Паранс

POST/api/v1/western/astrocartography/parans

Верните классические полосы широты парана in-mundo, близлежащие города и поля детерминированной интерпретации для наложения карт, исследования перемещения и пользовательского интерфейса горячих точек.

Полный URL-адрес

https://api.freeastroapi.com/api/v1/western/astrocartography/parans

Классическое поведение

Конечная точка парана является классической и предназначена только для in-mundo. Он не поддерживает проекционный режим.

Параны также требуют известного времени рождения, поскольку математика угловых событий зависит от точного момента рождения.

Параметры тела запроса

ParameterTypeReqDescription
natalobjectYesБлокировка натального запроса по одинаковому времени, используемая на конечных точках астрокартографии. Паранам требуется известное время рождения и определенные координаты.
bodiesмассив[строка]NoНеобязательное подмножество тел, используемое для генерации паранов. По умолчанию используется набор тел для живого производства, включая True Node.
eventsмассив[строка]NoНеобязательное подмножество угловых событий. Поддерживаемые значения: «asc», «dsc», «mc» и «ic».
min_abs_latnumberNoМинимальная абсолютная широта для поиска. По умолчанию 0,0.
max_abs_latnumberNoМаксимальная абсолютная широта для поиска. По умолчанию 66.0.
limitintegerNoВернулось максимальное количество паран-бандов. В живом примере используется 20. Максимальное количество серверов — 300.
paran_orb_degnumberNoПервичный шар парана в градусах. По умолчанию для прямой трансляции установлено значение 1.0.
paran_tail_degnumberNoУдлиненная полоса хвоста парана в градусах. По умолчанию для прямой трансляции установлено значение 2.0.
include_nearby_citiesbooleanNoПри true каждая возвращаемая полоса включает до трех близлежащих городов. В живом примере используется поведение по умолчанию.

Пример кода

Приведенный ниже пример запроса представляет собой полезную нагрузку реального производственного теста, использованную 14 апреля 2026 г., с отредактированным ключом API.

curl -X POST "https://api.freeastroapi.com/api/v1/western/astrocartography/parans" \
 -H "Content-Type: application/json" \
 -H "x-api-key: YOUR_API_KEY" \
 -d '{
  "natal": {
    "year": 1995,
    "month": 9,
    "day": 5,
    "hour": 20,
    "minute": 0,
    "city": "Paris",
    "lat": 48.8566,
    "lng": 2.3522,
    "tz_str": "Europe/Paris",
    "time_known": true,
    "house_system": "placidus"
  },
  "limit": 20
}'

Пример реального ответа

Это урезанная версия реального производственного ответа на тестовую полезную нагрузку в Париже. Каждое отображаемое поле взято из живого API.

{
  "meta": {
    "mode": "in_mundo",
    "bodies": [
      "sun",
      "moon",
      "mercury",
      "venus",
      "mars",
      "jupiter",
      "saturn",
      "uranus",
      "neptune",
      "pluto",
      "true_node"
    ],
    "events": ["asc", "dsc", "mc", "ic"],
    "timezone": "Europe/Paris",
    "paran_orb_deg": 1.0,
    "paran_tail_deg": 2.0,
    "geometry_format": "geojson",
    "coordinate_reference_system": "WGS84",
    "coordinate_order": "longitude_latitude",
    "count": 20
  },
  "warnings": [
    "Astrocartography results are exploratory and should be treated as directional rather than deterministic."
  ],
  "parans": [
    {
      "id": "sun:ic:jupiter:dsc:-21.105",
      "body_a": "sun",
      "event_a": "ic",
      "body_b": "jupiter",
      "event_b": "dsc",
      "latitude": -21.105,
      "orb_deg": 0.001,
      "geometry": {
        "type": "Polygon",
        "coordinates": [[
          [-180.0, -22.105],
          [180.0, -22.105],
          [180.0, -20.105],
          [-180.0, -20.105],
          [-180.0, -22.105]
        ]]
      },
      "nearest_cities": [
        {
          "name": "Ribeirão Preto",
          "country": "BR",
          "state": "Sao Paulo",
          "lat": -21.1775,
          "lng": -47.81028,
          "timezone": "America/Sao_Paulo",
          "population": 711825,
          "distance_km": 8.1
        },
        {
          "name": "Juiz de Fora",
          "country": "BR",
          "state": "Minas Gerais",
          "lat": -21.76417,
          "lng": -43.35028,
          "timezone": "America/Sao_Paulo",
          "population": 573285,
          "distance_km": 73.4
        }
      ],
      "strength": 1.0,
      "strongest_focus": "home",
      "secondary_focus": "health",
      "polarity": "supportive",
      "interpretation_short": "Sun IC with Jupiter DSC creates an expansion hotspot around 21.1° latitude. Best for home. Secondary pull: health.",
      "interpretation_caution": "Best use: expansion, confidence and recognition, while managing confidence can outrun realism, ego strain or burnout, excess or overreach.",
      "benefit_keywords": [
        "expansion",
        "confidence and recognition",
        "expansion and opportunity",
        "home and roots",
        "partnership and social mirroring",
        "home",
        "health"
      ],
      "risk_keywords": [
        "confidence can outrun realism",
        "ego strain or burnout",
        "excess or overreach",
        "mixed priorities"
      ]
    },
    {
      "id": "sun:mc:jupiter:asc:21.105",
      "body_a": "sun",
      "event_a": "mc",
      "body_b": "jupiter",
      "event_b": "asc",
      "latitude": 21.105,
      "orb_deg": 0.001,
      "...": "real response continues"
    },
    {
      "id": "sun:asc:jupiter:ic:51.254",
      "body_a": "sun",
      "event_a": "asc",
      "body_b": "jupiter",
      "event_b": "ic",
      "latitude": 51.254,
      "orb_deg": 0.0,
      "...": "real response continues"
    }
  ]
}

Поля ответа

FieldMeaning
meta.modeВсегда возвращает классический режим парана, используемый сервером. В настоящее время в прямом эфире возвращается `in_mundo`.
meta.bodiesФактический список тел, используемый после значений по умолчанию и проверки.
meta.eventsФактический список событий angular, используемый после значений по умолчанию и проверки.
meta.paran_orb_degРазрешенный основной шар, использованный для расчета.
meta.paran_tail_degРазрешенная хвостовая полоса, использованная для расчета.
meta.geometry_format / coordinate_reference_system / coordinate_orderМетаданные контракта геометрии. Геометрия Парана — это GeoJSON в WGS84 с порядком координат долгота/широта.
meta.countКоличество полос парана, возвращенных в полезной нагрузке.
parans[].latitudeЦентральная широта полосы паран.
parans[].geometryПолоса GeoJSON `Polygon` в порядке долготы/широты WGS84, покрывающая сферу Парана вокруг центральной широты.
parans[].nearest_citiesПри включении ближайший город соответствует этому диапазону широт.
parans[].strongest_focusСамая сильная ориентация на продукт наблюдается у пары паран.
parans[].secondary_focusВторичный фокус, который также хорошо подходит для пары паран.
parans[].polarityHigh-level поддержка/чтение задач для группы.
parans[].interpretation_shortКраткое изложение human-readable того, что подчеркивает эта паранская комбинация.