Рекомендации по астрокартографии

POST/api/v1/western/astrocartography/recommendations

Ранжируйте города-кандидаты по конкретному направлению переезда. Живой ответ объединяет сигналы линии, парана и relocation-chart, а затем возвращает объяснимые оценки, ссылки на близлежащие линии и дополнительную геометрию карты для приложений relocation-style.

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

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

Как работает рейтинг

Рейтинг рекомендаций является детерминированным. API оценивает города-кандидаты из отфильтрованного пула, а затем помечает общее качество результата значком signal_strength, confidence, и match_tier.

Конечная точка возвращает рейтинговые города, даже если совпадения слабые или смешанные. Он не скрывает рейтинг только потому, что высший балл скромен.

include_crossings по умолчанию false и требует доступа High-plan, когда он включен.

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

Parameter	Type	Req	Description
`natal`	object	Yes	Блокировка натального запроса в одно и то же время, используемая на западных конечных точках. Рекомендации требуют известного времени рождения и определенных координат.
`focus`	string	Yes	Первичный фокус на подсчете очков. Живая постановка поддерживает «карьеру», «романтику», «дом», «здоровье» и «духовность».
`country_scope`	string	No	Выбор географического охвата. Поддерживаемые значения: «own_country», «selected_countries» и «все».
`country`	string	No	Дополнительный фильтр single-country, используемый при поиске country-scoped.
`countries`	массив[строка]	No	Дополнительный список country-code, используемый при поиске selected-country. Живой пример проходит FR, ES и PT.
`limit`	integer	No	Возвращено максимальное количество ранжированных городов. Живой пример запрашивает 10.
`min_population`	integer	No	Меньшая численность населения направляется в города-кандидаты. В живом примере используется 100000.
`max_population`	integer	No	Необязательная верхняя граница населения для пула городов-кандидатов.
`city_size`	string	No	Ведро-фильтр дополнительного размера. Поддерживаемые значения: «маленький», «средний», «большой» и «мега».
`mode`	string	No	Режим расчета. По умолчанию «in_mundo». «прогнозируемый» также поддерживается.
`bodies`	массив[строка]	No	Необязательный подмножество тел для использования при оценке и дополнительном выводе карты.
`angles`	массив[строка]	No	Необязательное подмножество «asc», «dsc», «mc» и «ic».
`topocentric`	boolean	No	Дополнительный режим топоцентрического расчета. По умолчанию false.
`nearby_radius_km`	number	No	Радиус расстояния, используемый при поиске близлежащих городов в потоке подсчета очков. По умолчанию 1000.0.
`paran_orb_deg`	number	No	Первичная сфера парана. По умолчанию 1.0.
`paran_tail_deg`	number	No	Удлиненная повязка на хвосте парана. По умолчанию 2.0.
`include_map_lines`	boolean	No	При true ответ включает блок карты map-ready с геометрией линии. Это включено в примере живого ответа.
`include_crossings`	boolean	No	По умолчанию false. Перекрестное обогащение является High-plan только потому, что обнаружение пересечений и интерпретация горячих точек намного сложнее, чем простое ранжирование.
`include_paran_summary`	boolean	No	Определяет, включаются ли блоки сведений о паране в каждый ранжированный результат.
`include_relocation_summary`	boolean	No	Определяет, включен ли более легкий блок сводки о перемещении в каждый ранжированный результат.

Пример кода

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

curl -X POST "https://api.freeastroapi.com/api/v1/western/astrocartography/recommendations" \
 -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"
  },
  "focus": "home",
  "country_scope": "selected_countries",
  "countries": ["FR", "ES", "PT"],
  "limit": 10,
  "min_population": 100000
}'

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

Это урезанная версия реального производственного ответа. Значения рейтинга и полей реальны. Повторяющаяся геометрия карты сокращается, поэтому пример остается читабельным в документации.

{
  "meta": {
    "focus": "home",
    "mode": "in_mundo",
    "country_scope": "selected_countries",
    "city_size": null,
    "population_min": 100000,
    "population_max": null,
    "bodies": [
      "sun",
      "moon",
      "mercury",
      "venus",
      "mars",
      "jupiter",
      "saturn",
      "uranus",
      "neptune",
      "pluto",
      "true_node"
    ],
    "angles": ["asc", "dsc", "mc", "ic"],
    "timezone": "Europe/Paris",
    "candidate_count": 79,
    "scored_count": 79,
    "signal_strength": "moderate",
    "confidence": "medium",
    "match_tier": "mixed",
    "no_strong_matches": false
  },
  "warnings": [
    "Astrocartography results are exploratory and should be treated as directional rather than deterministic."
  ],
  "results": [
    {
      "city": {
        "name": "Lille",
        "country": "FR",
        "state": "Hauts-de-France",
        "lat": 50.63391,
        "lng": 3.05512,
        "timezone": "Europe/Paris",
        "population": 238695
      },
      "distance_from_natal_km": 204.0,
      "score": 10.33,
      "summary": "No strong home lines were found, but the closest supportive line is Sun IC at about 6109.8 km.",
      "supporting_line_id": "sun:ic",
      "distance_to_line_km": 6109.8,
      "nearest_point_on_line": {
        "type": "Point",
        "coordinates": [89.683877, 50.63391]
      },
      "supporting_line_polarity": "mixed",
      "top_factors": [],
      "nearest_favorable_distance_km": 6109.8,
      "nearest_challenging_distance_km": 5912.5,
      "nearest_favorable_line": {
        "body": "sun",
        "angle": "ic",
        "line_id": "sun:ic",
        "distance_km": 6109.8,
        "nearest_point_on_line": {
          "type": "Point",
          "coordinates": [89.683877, 50.63391]
        }
      },
      "nearest_challenging_line": {
        "body": "saturn",
        "angle": "ic",
        "line_id": "saturn:ic",
        "distance_km": 5912.5,
        "nearest_point_on_line": {
          "type": "Point",
          "coordinates": [159.336799, 50.63391]
        }
      },
      "line_score": 0.0,
      "paran_score": 10.33,
      "relocation_score": 0.0,
      "top_parans": [
        {
          "id": "sun:asc:jupiter:ic:51.254",
          "body_a": "sun",
          "event_a": "asc",
          "body_b": "jupiter",
          "event_b": "ic",
          "latitude": 51.254,
          "distance_km": 69.0,
          "score": 9.87
        }
      ],
      "nearest_favorable_paran": {
        "id": "sun:asc:jupiter:ic:51.254",
        "body_a": "sun",
        "event_a": "asc",
        "body_b": "jupiter",
        "event_b": "ic",
        "latitude": 51.254,
        "distance_km": 69.0
      },
      "nearest_challenging_paran": null,
      "rank": 1,
      "relocation_summary": {
        "resolved_timezone": "Europe/Paris",
        "angles": {
          "asc": 332.074,
          "mc": 258.436,
          "ic": 78.436,
          "dc": 152.074
        },
        "angular_planets": [],
        "dominant_themes": [],
        "summary_short": "Relocated chart is not strongly angular for the tracked bodies.",
        "summary_caution": "No strong relocated angular pressure was detected."
      },
      "signal_strength": "moderate",
      "match_tier": "mixed"
    },
    {
      "city": {
        "name": "Gasteiz / Vitoria",
        "country": "ES",
        "state": "Basque Country",
        "lat": 42.84998,
        "lng": -2.67268,
        "timezone": "Europe/Madrid",
        "population": 257407
      },
      "distance_from_natal_km": 772.6,
      "score": 7.91,
      "summary": "No strong home lines were found, but the closest supportive line is Sun IC at about 7529.0 km.",
      "line_score": 0.0,
      "paran_score": 7.91,
      "relocation_score": 0.0,
      "top_parans": [
        {
          "id": "mercury:ic:uranus:dsc:42.879",
          "body_a": "mercury",
          "event_a": "ic",
          "body_b": "uranus",
          "event_b": "dsc",
          "latitude": 42.879,
          "distance_km": 3.2,
          "score": 7.91
        }
      ],
      "relocation_summary": {
        "resolved_timezone": "Europe/Madrid",
        "angular_planets": [
          {
            "body": "jupiter",
            "angle": "mc",
            "orb_deg": 5.87,
            "house": 9
          }
        ],
        "dominant_themes": ["career", "spiritual"],
        "summary_short": "Relocated chart emphasizes career, spiritual through Jupiter MC.",
        "summary_caution": "Main caution is balance: strong angular emphasis can still narrow life around a few themes."
      },
      "signal_strength": "moderate",
      "match_tier": "mixed"
    }
  ],
  "map": {
    "meta": {
      "geometry_format": "geojson",
      "coordinate_reference_system": "WGS84",
      "line_sample_step_degrees": 0.25,
      "crossing_count": 0
    },
    "...": "map line geometry continues when include_map_lines is enabled"
  }
}

Поля ответа

Field	Meaning
`meta.focus`	Разрешенный фокус, используемый для ранжированного поиска.
`meta.country_scope`	Решенный географический охват после проверки запроса.
`meta.population_min / meta.population_max`	Фильтры населения, которые фактически применялись к пулу кандидатов.
`meta.candidate_count / meta.scored_count`	Сколько городов-кандидатов было рассмотрено и сколько было набрано баллов.
`meta.signal_strength / meta.confidence / meta.match_tier`	Top-level метки качества для возвращаемого рейтинга. Это полезно, когда лучшие совпадения сгруппированы или вообще слабы.
`meta.no_strong_matches`	Логический флаг, указывающий, что API не нашел явно сильного соответствия выбранному фокусу и фильтрам.
`results[].city`	Полезные данные города GeoService-shaped с именем, страной, штатом, координатами, часовым поясом и населением.
`results[].score`	Необработанный общий показатель рекомендаций, используемый для ранжирования. Это сумма компонентов линии, парана и перемещения.
`results[].line_score / results[].paran_score / results[].relocation_score`	Разбивка баллов Per-technique для объяснимого ранжирования.
`results[].summary`	Краткое объяснение, подходящее для перемещения карточек пользовательского интерфейса или списков результатов.
`results[].supporting_line_id / distance_to_line_km / nearest_point_on_line / supporting_line_polarity`	Основная ссылка на рейтинговый город. Это линия, которую клиент может выделить прямо на карте, причем ближайшая точка уже решена.
`results[].top_parans`	Highest-impact близлежащие параны вносят свой вклад в счет этого города.
`results[].nearest_favorable_line / results[].nearest_challenging_line`	Ближайшие вспомогательные и сложные ссылки на строки, используемые в слое объяснения. Каждая ссылка содержит `line_id` плюс GeoJSON `nearest_point_on_line`.
`results[].relocation_summary`	Более легкое резюме relocation-chart с указанным часовым поясом, угловыми планетами, доминирующими темами и кратким текстом интерпретации.
`map`	Дополнительная встроенная полезная нагрузка линии GeoJSON для отображения того же поиска на карте мира, когда включен include_map_lines.