ACG

Local Space Azimuth Lines (Go Engine)

Compute local space azimuth/altitude lines from observer location.

post/acg/local-space

Request

  • Base URL: https://api.openephemeris.com
  • URL: https://api.openephemeris.com/acg/local-space
  • Auth: one of:
    • HTTP bearer
    • API key in header X-OpenEphemeris-API-Key
    • API key in header X-API-Key
    • API key in header X-Service-Key

Request body

bodiesstring[]

Explicit body name selection; narrows the standard roster this endpoint otherwise returns in full. Supported: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, Chiron, Pholus, Ceres, Pallas, Juno, Vesta, MeanNode, TrueNode, MeanLilith, OscuLilith. The eight Uranian (Hamburg School) hypothetical points (Cupido, Hades, Zeus, Kronos, Apollon, Admetos, Vulkanus, Poseidon) are accepted too, but only when named here: they are opt-in and never appear in the default roster. SouthNode and TrueSouthNode are derived in place from the topocentric Mean/True Node; Vertex is cast from the natal birthplace and is the one roster body omitted when the request carries no natal block. There is no group selector on this endpoint, so the Hermetic lots are out of reach and are rejected. Earth is rejected too: its body id collides with the id this endpoint gives the Ascendant, so it cannot be represented alongside the angle lines. The four cardinal angle lines (Ascendant, Midheaven, Descendant, IC) are the local-space frame rather than bodies, and are always returned regardless of this field. Aliases: NorthNode/Rahu/Node -> MeanNode; TrueNorthNode/TrueRahu -> TrueNode; Ketu -> SouthNode; Vulcanus -> Vulkanus. The extended catalog is accepted too, by name and only when named: the sb441 main-belt asteroids (Hygiea, Eunomia, Psyche, Europa (asteroid), Cybele, Sylvia, Thisbe, Camilla, Iris, Davida, Euphrosyne, Interamnia), the trans-Neptunian objects (Eris, Sedna, Makemake, Haumea, Quaoar, Orcus, Ixion, Varuna, Chaos, Gonggong, Salacia), the extra centaurs (Asbolus, Hylonome, Nessus, Chariklo) and about forty further asteroids (Eros (asteroid), Sappho, Lilith (asteroid), Fortuna, Pandora, Diana, Hekate and more) - GET /catalogs/bodies lists them all. The asteroid Eros is Eros (asteroid): plain Eros is the Hermetic lot. Each extended body named adds 1 credit to the request (capped at +20); the standard roster, the Uranian set and the lots are covered by the base price. Extended bodies are never in a group's default roster.

epochstring required

ISO-8601 datetime of the birth or event. Either put the zone on the value itself as a 'Z' or ±HH:MM suffix ("1987-07-15T09:01:00-05:00"), or send the naive local wall-clock time ("1987-07-15T09:01:00") and name its zone in the sibling timezone field. A zone-less clock time with no timezone is rejected with 400 ambiguous_datetime and is NEVER read as UTC. A date-only value resolves to 12:00 UTC.

jdnumber double

Julian Day (alternative to epoch)

latnumber

Analysis target latitude. Canonical spelling; alias of 'target_lat'. Required as part of a complete coordinate pair -- a request with no complete pair is rejected rather than defaulting to 0,0. Distinct from 'query_lat', which is the optional proximity query point.

line_distance_kmnumber nullable

Distance to project local space lines in kilometers. Defaults to approximately 5550km (50 degrees).

lonnumber

Analysis target longitude. Canonical spelling; alias of 'target_lon'. Required as part of a complete coordinate pair -- a request with no complete pair is rejected rather than defaulting to 0,0. Distinct from 'query_lon', which is the optional proximity query point.

query_latnumber nullable

Latitude of the query point. When supplied with query_lon, each local-space line is annotated with its great-circle min distance.

query_lonnumber nullable

Longitude of the query point. When supplied with query_lat, each local-space line is annotated with its great-circle min distance.

response_format'json' | 'geojson' nullable

Response format ('json' or 'geojson'). Defaults to 'json'.

target_latnumber

Analysis target latitude. Accepted alias of 'lat' (matching /acg/ccg); ignored when 'lat' is present.

target_lonnumber

Analysis target longitude. Accepted alias of 'lon' (matching /acg/ccg); ignored when 'lon' is present.

Example request

{
  "epoch": "1990-06-15T14:30:00Z",
  "natal": {
    "birthplace_lat": 34.05,
    "birthplace_lon": -118.24
  },
  "options": {
    "asteroid_groups": [
      "centaur",
      "muse"
    ]
  }
}

Response

Successful Response

object required

Changes

No recorded changes to this operation across all 1 revision of this API.