# Vastu API: plan de casa, mandala, 16 zonas, informe

Envías el plano de una casa: contorno, ángulo al norte, habitaciones, objetos y la puerta principal, en píxeles de una imagen o en metros. A cambio, recibes la posición de cada habitación desde el centro, lo que dicen los textos al respecto, lo que se puede hacer y una imagen que puedes superponer directamente sobre el plano.

![Mandala de 81 celdas sobre un plano de 12 por 9 metros: cocina en el sureste, aseo en el noreste, puerta en pada E3](/vastu-plan-overlay.svg)

## Qué devuelve la API

| Endpoint | Créditos | Qué devuelve |
|---|---|---|
| `POST /v1/vastu/plan` | 20 | Para cada habitación y objeto: acimut, sectores 8, 16 y 32, celda de la mandala con deidad, veredicto con fuente; pada de la puerta; forma del contorno; hallazgos con correcciones; puntuación con banda |
| `POST /v1/render/vastu` | 20 | SVG en las coordenadas del plano con fondo transparente: mandala, 16 zonas u 8 direcciones |
| `POST /v1/reports/vastu` | 5 000 | Informe PDF con tu marca, en ucraniano o inglés |
| `POST /v1/vastu/zones` | 10 | 8, 16 o 32 sectores con límites exactos y, si se proporciona un plano, qué hay en cada zona |
| `POST /v1/vastu/rooms` | 10 | Veredicto y puntuación por direcciones, si el plano ya ha sido medido |
| `POST /v1/vastu/entrance` | 10 | Pada de la puerta principal y su consecuencia |
| `POST /v1/vastu/mandala` | 10 | Toda la mandala: 45 deidades y sus celdas |
| `POST /v1/vastu/directions` | 10 | Ocho direcciones con guardianes, planetas y reglas clásicas |

Descripción completa de los campos, ejemplos y códigos de error: [documentación de Vastu](/vedic/vastu/).

## De dónde vienen las reglas

Cada veredicto tiene un `basis`. `classical` significa que hay un verso detrás, y la fuente indica su número: **Brihat Samhita, capítulo 53** (traducción de Iyer de 1884, el sánscrito verificado para la forma de la parcela), **Mayamatam** para la segunda escuela clásica, **Muhurta Chintamani 12.21** para las habitaciones de dieciséis zonas. `convention` significa práctica moderna sin verso, y así se indica.

Tres escuelas a elegir: `brihat-samhita` (por defecto), `mayamata` y `sixteen-zone`. Las escuelas clásicas calculan los acimuts desde el centro del rectángulo de la mandala, la escuela de dieciséis zonas desde el centroide del área; la respuesta siempre indica desde cuál.

**Caution:**
**Algunas habitaciones son rechazadas por las escuelas clásicas.** El comedor, el balcón, el garaje y el tanque en el tejado no tienen una regla clásica, por lo que `brihat-samhita` y `mayamata` devuelven 400, no una respuesta inventada. En la escuela `sixteen-zone` se evalúan, con la etiqueta `convention`.

## Qué no hacemos

- **No leemos el plano de una imagen.** Tú mismo proporcionas la geometría, por lo que la imagen del plano con la dirección no sale de tu dispositivo: solo recibimos las coordenadas del contorno, las habitaciones y las puertas.
- **No prometemos resultados.** Las correcciones tienen una complejidad y una indicación de si se pueden deshacer, pero ninguna promete que algo cambiará. No ofrecemos productos: pirámides, yantras, figuras.
- **No inventamos reglas.** Una ubicación que no está cubierta por ninguna fuente tiene el veredicto `no-rule` y no se incluye en la evaluación.

## Para quién es esto

- **Proptech y agencias inmobiliarias**: evaluación del plano de un apartamento junto con otras características del inmueble.
- **Arquitectos y diseñadores de interiores**: verificación de un boceto según las reglas clásicas incluso antes de los planos.
- **Consultores de Vastu**: un informe con tu propia marca en un minuto en lugar de cálculos manuales.
- **Plataformas astrológicas**: Vastu junto con el mapa, con la misma clave y los mismos créditos.

## Preguntas

**¿Cómo establecer el norte si solo tengo una brújula?** Proporciona el ángulo, `northReference: "magnetic"` y la `declination` para tu ubicación. Sin declinación, se devolverá 400: las reglas se leen desde el norte verdadero.

**¿Qué pasa con un plano en forma de L?** Su centroide se encuentra fuera del plano. La respuesta lo advierte, las escuelas clásicas calculan desde el centro del rectángulo de la mandala, y las celdas en el recorte se marcan como `outsideContour`.

**¿Cuánto cuesta un informe?** 5 000 créditos, como otros informes PDF. Los informes no están disponibles en el plan gratuito; los cálculos de 10 y 20 créditos sí.
