Астрокартография City Check

POST/api/v1/western/astrocartography/city-check

Оцените один город для одного человека одновременно во всех общедоступных фокусах астрокартографии. Это конечная точка, которую можно использовать, когда клиент уже знает пункт назначения и ему нужна подробная разбивка вместо ранжированного поиска.

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

https://api.freeastroapi.com/api/v1/western/astrocartography/city-check

Что возвращает эта конечная точка

city-check оценивает одно место по пяти общественным направлениям за один звонок: карьера, романтика, дом, здоровье и духовность.

В ответе представлены необработанные оценки и компоненты оценок. Он не сводит все в единый нормализованный потребительский рейтинг.

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

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

Parameter	Type	Req	Description
`natal`	object	Yes	Блокировка натального запроса в одно и то же время, используемая на западных конечных точках. Для проверки города необходимо знать время рождения и определенные координаты.
`city`	string	Yes	Название целевого города, который нужно оценить для человека. Живой пример проверяет Лиссабон.
`country`	string	No	Необязательный код страны для устранения неоднозначности при поиске целевого города. Живой пример проходит PT.
`lat / lng`	номер / номер	No	Необязательные прямые координаты целевого города, если вы хотите обойти или ограничить поиск места.
`mode`	string	No	Режим расчета. По умолчанию «in_mundo». «прогнозируемый» также поддерживается.
`bodies`	массив[строка]	No	Необязательное подмножество тел для использования при оценке города.
`angles`	массив[строка]	No	Необязательное подмножество «asc», «dsc», «mc» и «ic».
`topocentric`	boolean	No	Дополнительный режим топоцентрического расчета. По умолчанию false.
`paran_orb_deg`	number	No	Первичная сфера парана. По умолчанию 1.0.
`paran_tail_deg`	number	No	Удлиненная повязка на хвосте парана. По умолчанию 2.0.
`include_map_lines`	boolean	No	По умолчанию true. Если эта функция включена, ответ включает блок «карта» с линейной геометрией для рисования контекста города на карте.
`include_crossings`	boolean	No	По умолчанию false. Перекрестное обогащение возможно только для High-plan.
`include_paran_summary`	boolean	No	Определяет, включены ли блоки детализации парана в каждую оценку фокуса.
`include_relocation_summary`	boolean	No	Определяет, включается ли сводка о перемещении top-level в полезные данные.

Пример кода

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

curl -X POST "https://api.freeastroapi.com/api/v1/western/astrocartography/city-check" \
 -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"
  },
  "city": "Lisbon",
  "country": "PT"
}'

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

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

{
  "city": {
    "name": "Lisbon",
    "country": "PT",
    "state": "Lisbon",
    "lat": 38.72509,
    "lng": -9.1498,
    "timezone": "Europe/Lisbon",
    "population": 517802
  },
  "overall_score": 58.46,
  "focus_scores": {
    "career": {
      "score": 151.55,
      "summary": "Jupiter MC is the strongest supportive line for this career search, with 3 nearby contributing line(s).",
      "top_factors": [
        {
          "line_id": "jupiter:mc",
          "body": "jupiter",
          "angle": "mc",
          "distance_km": 26.0,
          "nearest_point_on_line": {
            "type": "Point",
            "coordinates": [22.078336, 38.72509]
          },
          "weight": 1.25,
          "score": 123.91,
          "polarity": "supportive"
        },
        {
          "line_id": "pluto:mc",
          "body": "pluto",
          "angle": "mc",
          "distance_km": 562.4,
          "nearest_point_on_line": {
            "type": "Point",
            "coordinates": [3.930579, 38.72509]
          },
          "weight": -0.85,
          "score": -7.54,
          "polarity": "challenging"
        }
      ],
      "nearest_favorable_distance_km": 26.0,
      "nearest_challenging_distance_km": 562.4,
      "nearest_favorable_line": {
        "body": "jupiter",
        "angle": "mc",
        "line_id": "jupiter:mc",
        "distance_km": 26.0,
        "nearest_point_on_line": {
          "type": "Point",
          "coordinates": [22.078336, 38.72509]
        }
      },
      "nearest_challenging_line": {
        "body": "pluto",
        "angle": "mc",
        "line_id": "pluto:mc",
        "distance_km": 562.4,
        "nearest_point_on_line": {
          "type": "Point",
          "coordinates": [3.930579, 38.72509]
        }
      },
      "supporting_line_id": "jupiter:mc",
      "distance_to_line_km": 26.0,
      "nearest_point_on_line": {
        "type": "Point",
        "coordinates": [22.078336, 38.72509]
      },
      "supporting_line_polarity": "supportive",
      "line_score": 115.72,
      "paran_score": -6.83,
      "relocation_score": 42.66,
      "top_parans": [
        {
          "id": "jupiter:asc:saturn:ic:38.902",
          "body_a": "jupiter",
          "event_a": "asc",
          "body_b": "saturn",
          "event_b": "ic",
          "latitude": 38.902,
          "distance_km": 19.7,
          "score": -6.83
        }
      ],
      "nearest_favorable_paran": null,
      "nearest_challenging_paran": {
        "id": "jupiter:asc:saturn:ic:38.902",
        "body_a": "jupiter",
        "event_a": "asc",
        "body_b": "saturn",
        "event_b": "ic",
        "latitude": 38.902,
        "distance_km": 19.7
      }
    },
    "home": {
      "score": -16.64,
      "summary": "No strong home lines were found, but the closest supportive line is Sun IC at about 8573.8 km.",
      "top_factors": [],
      "nearest_favorable_distance_km": 8573.8,
      "nearest_challenging_distance_km": 6213.6,
      "nearest_favorable_line": {
        "body": "sun",
        "angle": "ic",
        "line_id": "sun:ic",
        "distance_km": 8573.8,
        "nearest_point_on_line": {
          "type": "Point",
          "coordinates": [89.683877, 38.72509]
        }
      },
      "nearest_challenging_line": {
        "body": "saturn",
        "angle": "ic",
        "line_id": "saturn:ic",
        "distance_km": 6213.6,
        "nearest_point_on_line": {
          "type": "Point",
          "coordinates": [159.336799, 38.72509]
        }
      },
      "supporting_line_id": "sun:ic",
      "distance_to_line_km": 8573.8,
      "nearest_point_on_line": {
        "type": "Point",
        "coordinates": [89.683877, 38.72509]
      },
      "supporting_line_polarity": "mixed",
      "line_score": 0.0,
      "paran_score": -16.64,
      "relocation_score": 0.0,
      "top_parans": [
        {
          "id": "jupiter:asc:saturn:ic:38.902",
          "body_a": "jupiter",
          "event_a": "asc",
          "body_b": "saturn",
          "event_b": "ic",
          "latitude": 38.902,
          "distance_km": 19.7,
          "score": -17.08
        }
      ],
      "nearest_favorable_paran": {
        "id": "mercury:ic:neptune:dsc:37.262",
        "body_a": "mercury",
        "event_a": "ic",
        "body_b": "neptune",
        "event_b": "dsc",
        "latitude": 37.262,
        "distance_km": 162.9
      },
      "nearest_challenging_paran": {
        "id": "jupiter:asc:saturn:ic:38.902",
        "body_a": "jupiter",
        "event_a": "asc",
        "body_b": "saturn",
        "event_b": "ic",
        "latitude": 38.902,
        "distance_km": 19.7
      }
    },
    "spiritual": {
      "score": 132.36,
      "summary": "Jupiter MC is the strongest supportive line for this spiritual search, with 3 nearby contributing line(s).",
      "line_score": 82.85,
      "paran_score": 27.33,
      "relocation_score": 22.18,
      "top_parans": [
        {
          "id": "jupiter:asc:saturn:ic:38.902",
          "body_a": "jupiter",
          "event_a": "asc",
          "body_b": "saturn",
          "event_b": "ic",
          "latitude": 38.902,
          "distance_km": 19.7,
          "score": 27.33
        }
      ]
    },
    "...": "live response also includes romance and health focus blocks"
  },
  "relocation_summary": {
    "resolved_timezone": "Europe/Lisbon",
    "angles": {
      "asc": 320.812,
      "mc": 247.047,
      "ic": 67.047,
      "dc": 140.812
    },
    "angular_planets": [
      {
        "body": "jupiter",
        "angle": "mc",
        "orb_deg": 0.2,
        "house": 10
      }
    ],
    "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."
  },
  "map": {
    "meta": {
      "mode": "in_mundo",
      "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
`city`	Решена полезная нагрузка целевого города с именем, страной, штатом, координатами, часовым поясом и населением.
`overall_score`	Совокупный исходный рейтинг по общедоступным фокусам. Это сводка whole-city, а не нормализованный рейтинговый диапазон.
`focus_scores`	Расклад Per-focus на карьеру, романтику, дом, здоровье и духовность. Каждый блок оценивается независимо.
`focus_scores.{focus}.score`	Общий балл за этот фокус в проверенном городе.
`focus_scores.{focus}.line_score / paran_score / relocation_score`	Technique-level объяснение того, откуда берется оценка фокуса.
`focus_scores.{focus}.top_factors`	Вклады ближайших линий и highest-impact, используемые в слое объяснения. Каждый фактор включает в себя line_id, GeoJSON nearest_point_on_line и полярность.
`focus_scores.{focus}.supporting_line_id / distance_to_line_km / nearest_point_on_line / supporting_line_polarity`	Основная линия связи для этого фокуса. Это позволяет клиенту напрямую выделить выбранную линию, не пересчитывая ближайшую геометрию.
`focus_scores.{focus}.top_parans`	Близлежащие паран-банды, которые существенно влияют на этот фокус.
`focus_scores.{focus}.nearest_favorable_line / nearest_challenging_line`	Ближайшие поддерживающие и сложные ссылки на линии для этого фокуса. Каждый из них содержит «line_id» плюс GeoJSON «nearest_point_on_line».
`focus_scores.{focus}.nearest_favorable_paran / nearest_challenging_paran`	Ближайшие поддерживающие и стимулирующие ссылки на паран для этого фокуса, если они присутствуют.
`relocation_summary`	Top-level relocation-chart сводка для проверенного города, включая разрешенный часовой пояс, углы, угловые планеты, доминирующие темы и краткий текст интерпретации.
`map`	Дополнительная встроенная полезная нагрузка геометрии линии GeoJSON для рендеринга карты, когда включен include_map_lines.