Vastu Assessment for New-Build Plots

A plot assessment typically involves two distinct polygons at different stages of a project:

• Site boundary polygon: the legal property boundary — the outer perimeter of the land parcel. This is used to assess the site's overall Vastu qualities: zone proportions, Brahmasthan, and entrance orientation relative to the land itself.
• Building footprint polygon: the outer wall line of the proposed building on the site. Used when a floor plan is available but construction has not begun. This tells you the building's zone map and whether the proposed footprint is well-positioned on the site.
• Floor plan polygons: once a preliminary floor plan exists, room polygons can be supplied to rooms[] to evaluate room placement against zones.

• Obtain the site boundary coordinates from the survey plan or title document. Convert to Cartesian vertices (x, y) in a consistent unit (metres preferred), with one corner as origin (0, 0).
• Establish the True North reference: measure the True North bearing of your plan's +Y (plan-up) axis, clockwise, using a surveyor's compass or GPS (0 if plan-up already points True North). This is north_angle.
• For entrance direction: identify the proposed main gate or main door bearing, clockwise from plan-up (with north_angle 0 that is a True North bearing). If not yet decided, run the analysis with candidate bearings to compare results.
• For slope, drainage and soil: these are outside the API's scope — record them separately and address in the architect/engineer brief.

A typical new-build plot assessment progresses through these stages:

The /vastu/mandala endpoint returns the 9×9 grid of 81 padas overlaid on the plot boundary. Each pada includes:

• pada_id, row and col: 1-indexed on the north-up grid, row 1 on the south edge and column 1 on the west edge, so R1C1 is the south-west corner pada and R5C5 the centre
• zone: the 8-direction zone of this pada, or BRAHMA for the 9 centre padas
• in_plot: whether the pada lies inside the plot
• is_brahmasthan: whether this pada is in the central 3×3 Brahmasthan cluster
• polygon: the geometric boundary of this pada clipped to the plot
• area: absolute area of this pada inside the plot, in squared input units; also area_exact when rounding collapsed a non-zero area to zero

Once a preliminary floor plan is available, supply room polygons to /vastu/plan/analyze or /vastu/room-placement. The API assigns each room to its directional zone and evaluates applicable placement rules.

You can iterate: adjust room polygon vertices, re-submit, and compare the resulting zone assignments and rule findings across design alternatives. The API has no memory between calls — each is stateless and independently computed.

The Vastu muhurta endpoint computes auspicious timing from Swiss Ephemeris planetary positions for the ceremony's date and location — not from birth data.

POST /api/v1/vastu/muhurta
X-API-Key: YOUR_API_KEY
Content-Type: application/json

{
  "event_type": "griha_pravesh",
  "date": "DD/MM/YYYY",
  "lat": <ceremony location latitude>,
  "lon": <ceremony location longitude>,
  "tz": <UTC offset, e.g. 5.5 for IST>
}

Muhurta selection involves assessment of the full ceremony chart (Lagna, tithi, nakshatra, yoga, karana and planetary positions at the auspicious hour). The API provides computed windows; a qualified Jyotishi's review of the specific muhurta is advisable for important events.