Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Astrocartography → Lines

AI-generated

Summary

Calculate astrocartography lines for a specified birth date and location, returning coordinate points for selected planets and line types.

Inputs

  • Year (required) — Birth year in 4-digit format (e.g., 1990).
  • Month (required) — Birth month as number 1-12 (January=1, December=12).
  • Day (required) — Birth day of month (1-31).
  • Hour (required) — Birth hour in 24-hour format (0-23, where 0=midnight, 12=noon).
  • Minute (required) — Birth minute (0-59).
  • Location Type (required) — Choose whether to specify birth location by city name or exact coordinates.
  • City (required) — Birth city name if location type is City Name (e.g., "London", "New York").
  • Country Code (required) — 2-letter ISO country code for the birth city (e.g., US, GB).
  • Latitude (required) — Geographic latitude of birth location in decimal degrees (-90 to 90, positive=North), if location type is Coordinates.
  • Longitude (required) — Geographic longitude of birth location in decimal degrees (-180 to 180, positive=East), if location type is Coordinates.
  • Planets (required) — Planets to include in the astrocartography calculation (e.g., Sun, Moon, Mars).
  • Line Types (required) — Types of angular lines to calculate for each planet: Ascendant (AC), Descendant (DS), Imum Coeli (IC), Midheaven (MC).
  • Coordinate Density (required) — Number of coordinate points per line (range: 20-500) affecting detail level.
  • Coordinate Precision (required) — Number of decimal places for latitude and longitude in output (2-6).
  • Simplify — Whether to return a simplified response with key data only; if false, returns full API response with all metadata.

Output shape

a single JSON object representing the calculated astrocartography lines for specified planets and line types, including arrays of geographic coordinate points per line.

Coordinate arrays correspond to each calculated line type and planet; coordinate density and precision affect the detail and format of these arrays. Simplify option affects output verbosity.

Examples

Example 1: Calculate AC and MC lines for Sun and Moon based on birth details for New York City in 1990.

Set year=1990, month=1, day=1, hour=12, minute=0, location type='city', city='New York', country code='US', select planets Sun and Moon, line types AC and MC, coordinate density 100, precision 4, simplify enabled.

Links

Discussion