Edificación

¿Hay una construcción dentro del lote? Respuesta sí/no con las huellas detectadas, y el informe PDF firmado.

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—.

Los datos salen de Google Open Buildings v3, un dataset de huellas de edificación derivado de imagen satelital de alta resolución.

Dos pasos

Fuente del diagrama (mermaid)

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

bash

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
  }'

El ring es el polígono del lote en [lng, lat], cerrado (el primer punto repetido al final). Si ya tenés el lote cargado, alcanza con aoiRef.

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

bash

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

Qué pasa	Respuesta	Por qué
Falta `Idempotency-Key`	`428`	La evaluación gasta cuota
Ni `ring` ni `aoiRef`	`422`	Hace falta saber sobre qué lote se pregunta
`ring` con menos de 4 puntos, o sin cerrar	`422`	No es un polígono
`minConfidence` fuera de 0–1	`422`	Es una probabilidad
El proveedor no responde	`status: "unavailable"`	Con `message`; no es un `hasBuilding: false`
Geometría degenerada (área cero)	`status: "invalid_geometry"`	Un lote sin superficie no se puede evaluar

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 dataset es un snapshot, no una foto de hoy. Una construcción posterior al corte no aparece, y su ausencia no prueba que el lote esté vacío. El informe declara la fecha del corte.
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.
Open Buildings 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.

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