Actividad eléctrica

¿Hubo descargas cerca del punto en esa ventana? Respuesta sí/no con las descargas, y el informe PDF firmado.

Responde una pregunta concreta: ¿hubo actividad eléctrica cerca de este punto, en esta ventana de tiempo? Sirve para decidir un siniestro de rayo sin mandar a nadie al campo.

Los datos salen del GLM (Geostationary Lightning Mapper) de los satélites GOES, que la NOAA publica libremente. No se le manda tu geometría a nadie: los archivos se descargan y se filtran de nuestro lado.

Dos pasos

La evaluación es barata y responde en el momento. El informe es opcional: si el resultado ya te alcanza para decidir, no hace falta emitir nada.

Fuente del diagrama (mermaid)

sequenceDiagram
    participant C as Tu sistema
    participant A as API
    C->>A: POST /v1/lightning/evaluations
    A-->>C: 200 · { evaluationId, detected, flashCount, nearest }
    Note over C: si con esto alcanza, terminás acá
    C->>A: POST /v1/lightning/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/lightning/evaluations" \
  -H "Authorization: Bearer $UCOTRON_API_KEY" \
  -H "content-type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "lat": -2.76,
    "lng": -60.52,
    "eventAt": "2026-06-26T17:22:00Z",
    "radiusKm": 20,
    "windowMin": 15
  }'

Campo	Qué es
`lat`, `lng`	El punto consultado. Alternativamente `aoi_ref` si tenés el lote cargado
`eventAt`	Momento del evento declarado, en UTC
`radiusKm`	Radio de búsqueda, hasta 100
`windowMin`	Ventana a cada lado de `eventAt`, hasta 180

La respuesta trae detected, flashCount, la descarga más cercana con su distancia y su desfasaje, y la lista completa de descargas. El signo del desfasaje importa: una descarga posterior al evento que declaraste no explica un daño anterior.

Mirá también coverage. Si es out_of_coverage o no_data, un detected: false no significa "no hubo rayos": significa que no pudimos mirar.

Emitir el informe

bash

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

Devuelve 202 con el trabajo. El poleo y la descarga están en Trabajos, entrega y errores.

El PDF trae el mapa satelital con el punto consultado, el círculo del radio y cada descarga marcada y numerada como en la tabla; el detalle de cada una con distancia, desfasaje y energía óptica; y el bloque de procedencia con los archivos GLM consultados.

Lo que se rompe

Qué pasa	Respuesta	Por qué
Falta `Idempotency-Key`	`428`	La evaluación gasta cuota: sin la clave, un reintento vuelve a pagar
`radiusKm` mayor a 100, o `windowMin` mayor a 180	`422`	Los topes están en el contrato; el cuerpo lista el campo en `issues`
`eventAt` en el futuro	`422`	No hay archivos GLM de un momento que no ocurrió
Emitir con un `evaluationId` que no existe o es de otra organización	el trabajo falla	El error nombra el identificador que no se encontró
Fecha anterior a ~2018	`coverage: out_of_coverage`	El sensor no existía; no es un `detected: false`

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

Qué afirma, y qué no

Esto es lo que hace defendible al documento, y conviene leerlo antes de prometerle algo a un asegurado:

GLM detecta actividad eléctrica total de forma óptica desde órbita. No distingue nube-tierra de intra-nube.
La resolución espacial es de ~8 km en el nadir y ~14 km sobre Argentina. La posición reportada es el centroide óptico del flash, no el punto de impacto a tierra.
La eficiencia de detección va de ~70 % de día a ~90 % de noche: una detección nula no prueba ausencia de rayos.
No se reporta corriente pico (kA) ni polaridad: GLM no los mide. La energía es óptica, en joules, y sirve como proxy relativo de intensidad.

Verifica actividad eléctrica en la vecindad. No es un certificado de impacto de rayo a tierra sobre un bien concreto.