← All endpoints / Vastu

Room Placement Analysis

POST/api/v1/vastu/room-placement
POSThttps://vedintelastroapi.com/api/v1/vastu/room-placement

Assigns each room to its 8-direction zone based on polygon centroid, then evaluates Vastu room-placement rules. Focused endpoint — no entrance or Brahmasthan analysis. rule_evaluation findings include source_type, source_verification_status, and interpretive_confidence.

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)
roomsYesstringRoom polygons: array of {name: string, polygon: Point[]} — at least 1 room required
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/room-placement" \
  -H "Content-Type: application/json" \
  -d '{
  "api_key": "YOUR_API_KEY",
  "plot": "VALUE",
  "rooms": "VALUE",
  "north_angle": 0,
  "lang": "en"
}'

Example Response

{
  "status": 200,
  "response": {
    "calculation": {
      "rooms": [
        {
          "name": "Master Bedroom",
          "zone_8": "NW",
          "centroid": {
            "x": 4,
            "y": 7.5
          },
          "bearing_from_plot_centre_deg": 292.62
        }
      ]
    },
    "rule_evaluation": {
      "findings": [],
      "positive_count": 0,
      "negative_count": 0,
      "critical_count": 0,
      "rules_version": "1.0.0"
    },
    "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 →