Edificación

Responde: ¿hay una edificación dentro de este lote? Sirve para verificar una declaración de riesgo sin visitar el campo —si el asegurado declara un galpón, o si declara que no hay nada—.

La detección se hace sobre huellas de edificación derivadas de teledetección satelital de alta resolución, con un corte de confianza declarado en cada respuesta.

Dos pasos

sequenceDiagram
    participant C as Tu sistema
    participant A as API
    C->>A: POST /v1/housing/evaluations
    A-->>C: 200 · { evaluationId, hasBuilding, buildingCount, totalAreaM2 }
    C->>A: POST /v1/housing/reports { evaluationId }
    A-->>C: 202 · trabajo encolado
    C->>A: GET /v1/reports/{id}/download
    A-->>C: 302 · el PDF

Evaluar

curl -s -X POST "$BASE/v1/housing/evaluations" \
  -H "Authorization: Bearer $UCOTRON_API_KEY" \
  -H "content-type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "ring": [[-59.95,-35.05],[-59.949,-35.05],[-59.949,-35.051],[-59.95,-35.051],[-59.95,-35.05]],
    "minConfidence": 0.65
  }'

Las tres formas de decir dónde

Por punto:

curl -s -X POST "$BASE/v1/housing/evaluations" \
  -H "Authorization: Bearer $UCOTRON_API_KEY" \
  -H "content-type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"lat": -34.121614, "lng": -59.724109, "radiusM": 50}'

Un punto no tiene superficie y el dataset entrega huellas, así que «acá» necesita un tamaño: radiusM es el radio alrededor del punto, 50 m por defecto —el radio de un casco de campo: cubre la casa y sus galpones sin arrastrar la del vecino— y hasta 500 m. Más que eso ya es un lote y va como ring.

El orden es [lng, lat], y Google Maps lo muestra al revés.

Un lote de Buenos Aires va [-59.72, -34.12]: la longitud primero. Si copiás de Google Maps —que muestra -34.12, -59.72— y lo pegás tal cual, el anillo es geométricamente válido y cae en el Atlántico Sur. La respuesta va a ser «no se detectaron edificaciones», y va a ser cierta: en el océano no hay ninguna.

No podemos detectarlo por vos: con esos valores las dos lecturas son números válidos y no hay forma de distinguirlas. Lo que sí hacemos es decirte qué coordenadas analizamos, con lat y lng nombrados, en el bloque de procedencia del informe. Si ahí ves una latitud que no es la de tu lote, es esto.

Cuando la inversión sí se puede probar —una «latitud» de más de 90, que no existe— la respuesta es 422 en vez de un análisis del lugar equivocado.

La forma de no equivocarse nunca es mandar el punto: lat y lng van con nombre, y un campo con nombre no se puede invertir.

minConfidence es el corte por debajo del cual una huella no se cuenta. Bajarlo aumenta los falsos positivos por sombras y vegetación densa; subirlo hace perder construcciones chicas. El default es un punto medio razonable.

La respuesta trae hasBuilding, buildingCount, maxConfidence, totalAreaM2, y la lista de huellas con su centroide, área y confianza.

Si status no es ok, no se puede afirmar nada sobre el lote: el campo message dice por qué.

Emitir el informe

curl -s -X POST "$BASE/v1/housing/reports" \
  -H "Authorization: Bearer $UCOTRON_API_KEY" \
  -H "content-type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"evaluationId":"ev_hsg_…","locale":"es-AR"}'

El PDF trae el mapa satelital con el lote dibujado y cada edificación marcada, con el tamaño de la marca proporcional a su superficie; la tabla de huellas con centroide, área y confianza; y la procedencia con el dataset y su corte.

Lo que se rompe

Cuando status no es ok, hasBuilding y buildingCount no afirman nada: el contrato impide que una corrida fallida reporte presencia.

La tabla completa de códigos está en Trabajos, entrega y errores.

Qué afirma, y qué no

• El relevamiento tiene una fecha de corte, no es una foto de hoy. Una construcción posterior no aparece, y su ausencia no prueba que el lote esté vacío. El informe lo advierte.
• Detecta huellas de edificación: no distingue vivienda de galpón, tinglado o silo.
• La cobertura es despareja fuera de zonas urbanas. En áreas rurales dispersas la detección es menos sensible.
• El relevamiento entrega el centroide y el área, no el contorno. Por eso el mapa marca posiciones y tamaños, y no dibuja la forma del edificio: no la conocemos.
• El anillo del lote tiene que venir cerrado: el primer y el último punto deben coincidir. Si no, la respuesta es 422 invalid_ring en vez de cerrarlo por su cuenta sobre una superficie que no pediste.

Verifica presencia de edificación detectable por satélite a la fecha del relevamiento. No reemplaza una inspección en campo.