← All endpoints / Vastu

Direction Classification

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

Classifies a compass bearing into 4-, 8-, and 16-direction systems with deity, Sanskrit name, and cultural metadata. No plot geometry required — pure angular computation.

Request Body (application/json)

FieldRequiredTypeDescription
api_keyNostringVedIntel API key (or use X-API-Key header)
bearing_degYesnumberCompass bearing in degrees (0–360, clockwise from True North)
north_angleNonumberTrue North bearing (degrees clockwise) of your plan +Y axis; the true bearing is (bearing_deg + north_angle) normalised to 0–360. Can also carry a magnetic-declination or survey offset. Default: 0
langNostringResponse language code. Default: en

Example Request

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

Example Response

{
  "status": 200,
  "response": {
    "calculation": {
      "input_bearing_deg": 45,
      "north_angle_applied": 0,
      "true_bearing_deg": 45,
      "direction_4": "E",
      "direction_8": "NE",
      "direction_16": "NE",
      "sector_16": {
        "name": "NE",
        "label_en": "North-East",
        "range_low_deg": 33.75,
        "range_high_deg": 56.25
      },
      "direction_8_metadata": {
        "label_en": "North-East",
        "label_hi": "Ishan",
        "label_sa": "Ishana",
        "deity": "Ishana (Shiva)"
      },
      "entrance_classification": {
        "deity": "Ishana (Shiva)",
        "label_en": "North-East",
        "label_hi": "Ishan",
        "label_sa": "Ishana"
      }
    },
    "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 →