Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Astrocartography → Location Analysis

AI-generated

Summary

Analyzes the astrological influences and characteristics of a specified target location based on a subject's birth data and birth location, providing insights into how relocation to or presence at that location may affect the individual.

Inputs

  • year (required) — Birth year in 4-digit format (e.g., 1990).
  • month (required) — Birth month as a number from 1 to 12 (January = 1, December = 12).
  • day (required) — Birth day of the month (1 to 31).
  • hour (required) — Birth hour in 24-hour format (0-23, where 0 = midnight, 12 = noon).
  • minute (required) — Birth minute (0-59).
  • locationType (required) — Specifies how to input birth location: either by 'City Name' (auto-detecting coordinates) or by exact 'Coordinates' (latitude and longitude).
  • city (required) — Birth city name, required if locationType is 'city' (e.g., "London", "New York").
  • countryCode (required) — Two-letter ISO country code for the birth city (e.g., US, GB), required if locationType is 'city'.
  • latitude (required) — Geographic latitude in decimal degrees (-90 to 90, positive = North), required if locationType is 'coordinates'.
  • longitude (required) — Geographic longitude in decimal degrees (-180 to 180, positive = East), required if locationType is 'coordinates'.
  • targetCity — Target city name for the location to be analyzed (optional).
  • targetCountryCode — Two-letter ISO country code for the target city (optional).
  • targetLatitude — Target location latitude in decimal degrees (-90 to 90) for precise location analysis (optional).
  • targetLongitude — Target location longitude in decimal degrees (-180 to 180) for precise location analysis (optional).
  • simplify — Boolean flag to request a simplified response containing key data only; disable this to receive full API response with all metadata.

Output shape

a single object containing astrological location analysis data for the specified target location relative to the subject's birth data

The response shape depends on the simplify parameter: when enabled, only key data fields are returned; otherwise, the full detailed API response is provided including all metadata.

Examples

Example 1: Analyze how relocating to New York might affect an individual born in London on June 15, 1990 at 14:30.

Input the subject's birth data and original birth city (London, GB), specify the target city as New York with its country code (US), and enable simplify for concise results.

Links

Discussion