Астрокартографические линии

POST/api/v1/western/astrocartography/lines

Возвращает плотную геометрию линий WGS84 GeoJSON для карт мира. Полезная нагрузка для живого производства представляет каждую линию астрокартографии как непосредственно визуализируемую. LineString or MultiLineStringв порядке долгота/широта.

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

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

Планирование и доступ

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

include_crossings по умолчанию false. Если установлено значение true, конечная точка требует доступа к плану High и возвращает ошибку `403 high_plan_required` для вызывающих абонентов free-tier.

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

Parameter	Type	Req	Description
`natal`	object	Yes	Блокировка натального запроса в то же время, используемая западными конечными точками. Астрокартография требует известного времени рождения и определенных координат.
`mode`	string	No	По умолчанию «in_mundo». «Проецируемый» также поддерживается для генерации линий.
`bodies`	массив[строка]	No	Необязательное подмножество тел для расчета. По умолчанию для живого производственного набора: Солнце через Плутон плюс Истинный Узел.
`angles`	массив[строка]	No	Необязательное подмножество «asc», «dsc», «mc» и «ic». Все четыре возвращаются по умолчанию.
`topocentric`	boolean	No	Дополнительный режим топоцентрического расчета. По умолчанию false.
`include_crossings`	boolean	No	По умолчанию false. Когда true, конечная точка пытается обнаружить пересечение линий и расширить зону доступа премиум-класса. Это только High-plan.

Пример кода

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

curl -X POST "https://api.freeastroapi.com/api/v1/western/astrocartography/lines" \
 -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"
  }
}'

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

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

{
  "meta": {
    "mode": "in_mundo",
    "bodies": [
      "sun",
      "moon",
      "mercury",
      "venus",
      "mars",
      "jupiter",
      "saturn",
      "uranus",
      "neptune",
      "pluto",
      "true_node"
    ],
    "angles": ["asc", "dsc", "mc", "ic"],
    "timezone": "Europe/Paris",
    "geometry_format": "geojson",
    "coordinate_reference_system": "WGS84",
    "coordinate_order": "longitude_latitude",
    "line_sample_step_degrees": 0.25,
    "crossing_count": 0
  },
  "warnings": [
    "Astrocartography results are exploratory and should be treated as directional rather than deterministic."
  ],
  "lines": [
    {
      "id": "sun:asc",
      "body": "sun",
      "angle": "asc",
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [-156.218897, -68.75],
          [-151.470534, -68.5],
          [-148.257733, -68.25],
          [-145.683564, -68.0],
          "... dense WGS84 lon/lat coordinates continue ...",
          [179.713656, 0.0],
          [179.683877, 0.25],
          [179.654093, 0.5]
        ]
      }
    },
    {
      "id": "sun:mc",
      "body": "sun",
      "angle": "mc",
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [-90.316123, -89.0],
          [-90.316123, -88.75],
          [-90.316123, -88.5],
          "...",
          [-90.316123, 88.75],
          [-90.316123, 89.0]
        ]
      }
    }
  ],
  "crossings": []
}

Поля ответа

Field	Meaning
`meta.mode`	Разрешён режим астрокартографии для ответа.
`meta.bodies`	Фактический список тел, используемый сервером после значений по умолчанию и проверки.
`meta.angles`	Фактический список углов, используемый сервером после значений по умолчанию и проверки.
`meta.timezone`	Разрешенный часовой пояс, используемый для определения момента рождения.
`meta.geometry_format / coordinate_reference_system / coordinate_order`	Метаданные контракта геометрии. Полезная нагрузка линии — GeoJSON в WGS84 с порядком координат долгота/широта.
`meta.line_sample_step_degrees`	Плотный интервал выборки, используемый для обеспечения прямой визуализации возвращаемой геометрии линии на 2D-карте.
`meta.crossing_count`	Количество пересечений, прикрепленных к полезной нагрузке. Это значение остается равным 0, когда пересечения не запрашиваются.
`warnings`	Пояснительные или геометрические предупреждения. Живой ответ по умолчанию включает предупреждение exploratory-use.
`lines[].geometry`	Полная геометрия линии WGS84 GeoJSON. Сервер возвращает LineString, если путь непрерывен, и MultiLineString, когда его необходимо разделить по линии даты или по реальным разрывам.
`crossings`	Присутствует в полезных данных, но по умолчанию пуст. Реальные данные пересечения возвращаются только тогда, когда `include_crossings=true` и вызывающая сторона имеет доступ к High-plan. Каждое пересечение несет в себе точку геометрии GeoJSON, а также парные линии и поля интерпретации.

Пример премиальных ворот

Это настоящий «403», возвращенный 14 апреля 2026 года, когда та же конечная точка была вызвана с помощью include_crossings=true с помощью ключа free-tier API.

{
  "detail": {
    "error": "high_plan_required",
    "message": "Astrocartography crossings require the High plan because intersection discovery and hotspot enrichment consume significantly more compute than plain line generation.",
    "required_plan": "High",
    "current_plan": "Free",
    "upgrade_required": true,
    "endpoint": "/api/v1/western/astrocartography/lines"
  }
}