Eclipse Path Map (SVG)

POST

/render/eclipse-path

request.sh

curl -X POST https://api.astroway.info/v1/render/eclipse-path \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "path": [ { "latitude": 40, "longitude": -100 }, { "latitude": 35, "longitude": -90 } ], "bandWidthDeg": 3, "title": "Eclipse 2026" }'

▸ Спробувати POST /render/eclipse-path

• Production

Equirectangular world graticule with caller-supplied eclipse track. Renders centerline + shaded band of given degree-width.

Authorizations

• ApiKeyAuth

Parameters

Query Parameters

fields

string

Comma-separated dotted paths, relative to data, to keep in the response. A path is applied to every element of an array, so planets.name means the name of each planet. Paths that match nothing come back in _fields_unmatched; a list where nothing matches at all is a 400, because an empty object would be a confident wrong answer.

Example

planets.name,planets.longitude

precision

integer

<= 15

Round every non-integer number in the response to this many decimal places. Integers are left alone, because an id is not a measurement. Ecliptic longitudes ship with fourteen decimals by default; 2 is about a tenth of an arcminute.

Example

4

Header Parameters

Idempotency-Key

string

>= 1 characters <= 255 characters /^[\x21-\x7E]+$/

Unique per logical operation, kept across retries. For 24 hours from the first request, a repeat with the same key, method, path, body and query string returns the stored response with Idempotent-Replayed: true and costs 0 credits. The same key with a different body or query string is a 409 IDEMPOTENCY_KEY_REUSED; a repeat while the first is still running is a 409 IDEMPOTENCY_IN_PROGRESS. Only 2xx responses are kept. See /idempotency/.

Example

01HXY2A7ZM0ABCDEF

Request Body ^required

Media type application/json

object

path required

Array<object>

>= 2 items <= 500 items

object

latitude required

number

>= -90 <= 90

longitude required

number

>= -180 <= 180

time

string

<= 40 characters

centerlinePoints

Array<object>

<= 500 items

object

latitude required

number

>= -90 <= 90

longitude required

number

>= -180 <= 180

time

string

<= 40 characters

bandWidthDeg

number

>= 0.1 <= 20

title

string

<= 120 characters

options

object

size

integer

>= 200 <= 2000

theme

Css paints every colour as var(—aw-, ), so the page that inlines the SVG can recolour it with CSS custom properties (—aw-chart-bg, —aw-fg, —aw-muted, —aw-ring, —aw-houses-fill, —aw-benefic, —aw-malefic, —aw-aspect-harmonious, —aw-aspect-tense, —aw-aspect-neutral, —aw-aspect-minor, —aw-aspect-quintile, —aw-moon-shadow, —aw-moon-light, —aw-cycle-physical, —aw-cycle-emotional, —aw-cycle-intellectual). With none set it looks exactly like light. Inside an the variables cannot be set, so it stays light. The Western wheels and the aspect grid then also carry stable aw-* classes, and each planet is a with data-planet and data-label, each aspect line has data-a and data-b; see the @astroway/render changelog for the list.

string

Allowed values: light dark console css

showAspects

boolean

showRetrograde

boolean

title

string

<= 120 characters

format

string

default: json

Allowed values: svg json

width

integer

>= 400 <= 3000

height

integer

>= 200 <= 1500

showGraticule

boolean

pathColor

string

<= 20 characters

Example

{
  "path": [
    {
      "latitude": 40,
      "longitude": -100
    },
    {
      "latitude": 35,
      "longitude": -90
    }
  ],
  "bandWidthDeg": 3,
  "title": "Eclipse 2026"
}

Responses

200

Successful calculation

Media type application/json

object

ok

boolean

data

object

svg

string

nullable

format

string

nullable

byteLength

number

nullable

Example

{
  "ok": true,
  "data": {
    "svg": "<svg ...>",
    "format": "svg",
    "byteLength": 4671
  }
}

400

Validation error

Media type application/json

Example

{
  "ok": false,
  "error": {
    "code": "INVALID_INPUT",
    "message": "Validation failed: date: Date must be YYYY-MM-DD",
    "details": [
      {
        "path": "date",
        "message": "Date must be YYYY-MM-DD"
      }
    ]
  }
}

401

Missing or invalid API key

Media type application/json

Example

{
  "ok": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Invalid API key"
  }
}