The 8, 16 or 32 zones

POST

/vastu/zones

request.sh

curl -X POST https://api.astroway.info/v1/vastu/zones \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "granularity": 16 }'

▸ Try it POST /vastu/zones

• Production

The compass split into 8, 16 or 32 centred sectors with exact bounds. For 16, each zone carries its room from Muhurta Chintamani 12.21, a short reading in our own words, elements and colours as sourced variants (writers disagree), and a guardian and planet only where a source names one. Send a plan in the /vastu/plan format and each zone lists the rooms and fixtures that fall in it, read from the area centre or the grid centre.

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

coords

object

system required

string

Allowed values: image metric

width

number

height

number

normalized

boolean

units

string

Allowed values: m ft

northAngle

number

>= -360 <= 360

northReference

string

Allowed values: true magnetic

declination

number

>= -90 <= 90

boundary

Array<Array<number>>

>= 3 items <= 500 items

rooms

Array<object>

<= 60 items

object

type required

string

>= 1 characters <= 40 characters

label

string

<= 60 characters

point

Array<number>

>= 2 items <= 2 items

polygon

Array<Array<number>>

>= 3 items <= 200 items

items

Array<object>

<= 60 items

object

type required

string

>= 1 characters <= 40 characters

label

string

<= 60 characters

point

Array<number>

>= 2 items <= 2 items

polygon

Array<Array<number>>

>= 3 items <= 200 items

entrance

Array<number>

>= 2 items <= 2 items

entranceMethod

string

Allowed values: eight-per-side mandala-cells

facing

string

Allowed values: E S W N

school

string

Allowed values: brihat-samhita mayamata sixteen-zone

scoreVersion

Any of:

number

number

Allowed values: 1

number

number

Allowed values: 2

granularity

Any of:

number

number

Allowed values: 8

number

number

Allowed values: 16

number

number

Allowed values: 32

centre

string

Allowed values: area grid

Example

{
  "granularity": 16
}

Responses

200

Successful calculation

Media type application/json

object

ok

boolean

data

object

granularity

number

nullable

order

Array<string>

nullable

from

nullable

zones

Array<object>

nullable

object

zone

string

nullable

index

number

nullable

from

number

nullable

to

number

nullable

centre

number

nullable

verseRoom

object

word

string

nullable

meaning

string

nullable

basis

string

nullable

source

string

nullable

theme

string

nullable

themeBasis

string

nullable

elements

Array<object>

nullable

object

value

string

nullable

source

string

nullable

colours

Array<object>

nullable

object

value

string

nullable

source

string

nullable

dikpala

string

nullable

planet

string

nullable

warnings

Array

nullable

notes

Array<string>

nullable

Example

{
  "ok": true,
  "data": {
    "granularity": 16,
    "order": [
      "N",
      "NNE",
      "NE",
      "ENE",
      "E",
      "ESE",
      "SE",
      "SSE",
      "S",
      "SSW",
      "SW",
      "WSW",
      "W",
      "WNW",
      "NW",
      "NNW"
    ],
    "from": null,
    "zones": [
      {
        "zone": "N",
        "index": 0,
        "from": 348.75,
        "to": 11.25,
        "centre": 0,
        "verseRoom": {
          "word": "bhāṇḍāra",
          "meaning": "Treasury and stores.",
          "basis": "classical",
          "source": "Muhurta Chintamani 12.21 (Chowkhamba 1948; Motilal Banarsidass 1979)"
        },
        "theme": "Keeping what is valuable; money and stock.",
        "themeBasis": "convention",
        "elements": [
          {
            "value": "water",
            "source": "Online-Compass, 16 zones table"
          },
          {
            "value": "water",
            "source": "Vasterior, 16 zone Vastu"
          }
        ],
        "colours": [
          {
            "value": "blue",
            "source": "AstraRoot, Vastu zones and colours"
          }
        ],
        "dikpala": "Kubera",
        "planet": "Mercury"
      }
    ],
    "warnings": [],
    "notes": [
      "Sectors are centred on north and half-open clockwise: N is 337.5-22.5 in 8, 348.75-11.25 in 16, 354.375-5.625 in 32. The 32 angular sectors are not the 32 perimeter padas of /vastu/entrance."
    ]
  }
}

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"
  }
}