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

Перемещение астрокартографии

Перемещение астрокартографии

POST/api/v1/western/astrocartography/relocation

Возвращает полную перемещенную диаграмму для целевого города, а также более упрощенную сводку о перемещении, настроенную для удобства перемещения. Эта конечная точка является дополнением full-chart к сводным блокам, представленным рекомендациями и проверкой города.

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

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

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

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

Use relocation_summary для карточек карт и быстрого пользовательского интерфейса и используйте вложенный chart блокируйте, когда вам нужны полные данные диаграммы для продукта astrologer-facing.

Часовой пояс целевого города отображается в city.timezone and relocation_summary.resolved_timezone.

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

ParameterTypeReqDescription
natalobjectYesБлокировка натального запроса в одно и то же время, используемая на западных конечных точках. Для переезда необходимо знать время рождения и определенные координаты рождения.
citystringYesЦелевой город для перемещенной карты. В живом примере используется Лиссабон.
countrystringNoНеобязательный код страны для устранения неоднозначности при поиске города.
lat / lngномер / номерNoНеобязательные прямые координаты целевого города, если вы хотите обойти или ограничить поиск места.
natal.house_systemstringNoСистема домов проходила через натальный блок. В живом примере используется плацидус, а перемещенная карта сохраняет эту систему домов.

Пример кода

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

curl -X POST "https://api.freeastroapi.com/api/v1/western/astrocartography/relocation" \
 -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
  },
  "relocation_summary": {
    "resolved_timezone": "Europe/Lisbon",
    "angles": {
      "asc": 320.812,
      "mc": 247.047,
      "ic": 67.047,
      "dc": 140.812
    },
    "angles_details": {
      "asc": {
        "sign": "Aqu",
        "sign_id": "aquarius",
        "pos": 20.812,
        "abs_pos": 320.812,
        "house": 1
      },
      "mc": {
        "sign": "Sag",
        "sign_id": "sagittarius",
        "pos": 7.047,
        "abs_pos": 247.047,
        "house": 10
      },
      "ic": {
        "sign": "Gem",
        "sign_id": "gemini",
        "pos": 7.047,
        "abs_pos": 67.047,
        "house": 4
      },
      "dc": {
        "sign": "Leo",
        "sign_id": "leo",
        "pos": 20.812,
        "abs_pos": 140.812,
        "house": 7
      }
    },
    "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."
  },
  "chart": {
    "subject": {
      "name": "User",
      "datetime": "1995-09-05T20:00:00+02:00",
      "location": {
        "city": "Lisbon",
        "lat": 38.72509,
        "lng": -9.1498,
        "timezone": "Europe/Lisbon"
      },
      "settings": {
        "house_system": "placidus",
        "julian_day": 2449966.25,
        "zodiac_type": "Tropical",
        "time_known": true
      }
    },
    "planets": [
      {
        "id": "sun",
        "name": "Sun",
        "sign": "Vir",
        "sign_id": "virgo",
        "pos": 12.705,
        "abs_pos": 162.705,
        "retrograde": false,
        "house": 7
      },
      {
        "id": "jupiter",
        "name": "Jupiter",
        "sign": "Sag",
        "sign_id": "sagittarius",
        "pos": 7.247,
        "abs_pos": 247.247,
        "retrograde": false,
        "house": 10
      },
      {
        "id": "saturn",
        "name": "Saturn",
        "sign": "Pis",
        "sign_id": "pisces",
        "pos": 22.019,
        "abs_pos": 352.019,
        "retrograde": true,
        "house": 1
      },
      "... more planets in the real response ..."
    ],
    "aspects": [
      {
        "p1": "sun",
        "p2": "venus",
        "type": "conjunction",
        "orb": 4.31,
        "deg": 0,
        "is_major": true
      },
      {
        "p1": "jupiter",
        "p2": "sun",
        "type": "square",
        "orb": 5.46,
        "deg": 90,
        "is_major": true
      }
    ],
    "aspects_summary": {
      "total": 31,
      "major": 31,
      "minor": 0,
      "by_type": {
        "conjunction": 5,
        "square": 9,
        "sextile": 8,
        "trine": 7,
        "opposition": 2
      }
    },
    "confidence": {
      "houses": "high",
      "angles": "high",
      "overall": "high"
    },
    "houses": [
      {
        "house": 1,
        "name": "1",
        "sign": "Aqu",
        "sign_id": "aquarius",
        "pos": 20.812,
        "abs_pos": 320.812
      },
      {
        "house": 10,
        "name": "10",
        "sign": "Sag",
        "sign_id": "sagittarius",
        "pos": 7.047,
        "abs_pos": 247.047
      }
    ],
    "angles": {
      "asc": 320.812,
      "mc": 247.047,
      "ic": 67.047,
      "dc": 140.812,
      "vertex": 162.498
    },
    "...": "full relocated chart continues in the real response"
  },
  "meta": {
    "mode": "in_mundo",
    "timezone": "Europe/Paris",
    "house_system": "placidus"
  },
  "warnings": [
    "Astrocartography results are exploratory and should be treated as directional rather than deterministic."
  ]
}

Поля ответа

FieldMeaning
cityРазрешенная полезная нагрузка целевого города, включая разрешенный целевой часовой пояс.
relocation_summaryСлой сжатой интерпретации с перемещенными углами, угловыми планетами, доминирующими темами и кратким текстом.
relocation_summary.resolved_timezoneРазрешенный часовой пояс для целевого города. Это часовой пояс, который будет использоваться при представлении контекста перемещенного местоположения.
chart.subjectПеремещен тематический блок диаграммы, включая целевое местоположение и настройки, используемые для создания диаграммы.
chart.planetsПолностью перенесены планетарные позиции и дома.
chart.aspects / chart.aspects_summaryПеремещенный список аспектов плюс суммарное количество по типам аспектов.
chart.confidenceМетки достоверности для перемещенных выходных данных диаграммы. Живой пример возвращает высокую достоверность для домов, углов и в целом.
chart.houses / chart.angles / chart.angles_detailsПолностью перемещены вершины и углы домов, включая разбивку знаков и absolute-position.
meta.mode / meta.house_systemРешены метаданные расчета для запроса на перемещение.
meta.timezoneЧасовой пояс расчета Natal-side, используемый для определения базового момента времени. Перемещенный целевой часовой пояс возвращается отдельно в полях «city.timezone» и «relocation_summary.resolved_timezone».
warningsПоясняющие предостережения или примечания к расчетам, возвращаемые вместе с полезной нагрузкой.