← All endpoints / Vastu

Zone Partitioning

POST/api/v1/vastu/zones
POSThttps://vedintelastroapi.com/api/v1/vastu/zones

Computes the 8-direction zone polygons for a plot. Each zone is the intersection of the plot with a 45° sector centred on the plot centroid, returned with area and area_pct.

Request Body (application/json)

FieldRequiredTypeDescription
api_keyNostringVedIntel API key (or use X-API-Key header)
plotYesstringPlot polygon: array of {x, y} vertices (min 3; open or closed — a last vertex equal to the first is accepted)
north_angleNonumberTrue North bearing (degrees clockwise) of your plan +Y axis. Every bearing is converted with true bearing = bearing + north_angle, and polygons are rotated into a True North frame. Default: 0
langNostringResponse language code. Default: en

Example Request

curl -X POST "https://vedintelastroapi.com/api/v1/vastu/zones" \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_API_KEY",
  "plot": "VALUE",
  "north_angle": 0,
  "lang": "en"
}'

Example Response

{
  "status": 200,
  "response": {
    "calculation": {
      "plot_area": 200,
      "centroid": {
        "x": 10,
        "y": 5
      },
      "zones": [
        {
          "direction_8": "N",
          "label_en": "North",
          "deity": "Kubera",
          "polygon": [
            {
              "x": 10,
              "y": 5
            },
            {
              "x": 12.07,
              "y": 10
            },
            {
              "x": 7.93,
              "y": 10
            }
          ],
          "area": 10.36,
          "area_pct": 5.18
        },
        {
          "direction_8": "NE",
          "label_en": "North-East",
          "deity": "Ishana (Shiva)",
          "polygon": [
            {
              "x": 20,
              "y": 10
            }
          ],
          "area": 29.89,
          "area_pct": 14.95
        }
      ]
    },
    "rule_evaluation": null,
    "interpretation": null,
    "metadata": {
      "geometry_engine_version": "1.0.0",
      "vastu_rules_version": "1.0.0",
      "coordinate_system": "cartesian_true_north",
      "north_reference": "true_north",
      "north_angle_applied_deg": 0,
      "precision": {
        "bearing_dp": 2,
        "area_dp": 2,
        "overlap_pct_dp": 2,
        "units": "same as input polygon coordinates",
        "rounding_method": "round half away from zero",
        "internal_precision": "double"
      },
      "ayanamsa": null
    }
  },
  "remaining_api_calls": 4998
}
← Back to all endpointsInteractive Docs
Get a free API key →