Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Astrocartography → Map

AI-generated

Summary

Generate an astrocartography map based on a person's birth data specifying their birth date and time along with birth location, either by city name or exact coordinates. Select which planetary lines to include and the types of angles (ascendant, midheaven, descendant, imum coeli) to render on the map. Optionally simplify the output.

Inputs

  • Year (required) — Birth year in 4-digit format (e.g., 1990).
  • Month (required) — Birth month as a number from 1 (January) to 12 (December).
  • Day (required) — Birth day of the 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 how to specify birth location: by city name (auto-detects coordinates) or by exact latitude and longitude.
  • City (required) — Birth city name (e.g., "London", "New York", "Kyiv"). Required if location type is City Name.
  • Country Code (required) — 2-letter ISO country code for the birth city (e.g., US, GB, UA, DE, FR). Required if location type is City Name.
  • Latitude (required) — Geographic latitude of birth location in decimal degrees (-90 to 90, positive=North). Required if location type is Coordinates.
  • Longitude (required) — Geographic longitude of birth location in decimal degrees (-180 to 180, positive=East). Required if location type is Coordinates.
  • Planets (required) — Select the planets for which to calculate astrocartography lines (default includes Sun, Moon, Venus, Mars, Jupiter).
  • Line Types (required) — Select types of angular lines to include: AC (Ascendant), DS (Descendant), IC (Imum Coeli), MC (Midheaven). Default is AC and MC.
  • Simplify — Whether to return a simplified response with only key data fields (true) or the full API response including all metadata (false). Defaults to true.

Output shape

a single JSON object containing the generated astrocartography map data for the specified birth data and selected planets and lines.

Output may be simplified or full depending on the 'Simplify' input option. Simplified output contains only the most relevant top-level data, while full output includes complete details and metadata from the API.

Links

Discussion