Geofence

O geofence restringe check-ins a uma área geográfica. Útil para garantir que a pessoa está fisicamente presente no local do evento.

---

Comportamento

Configuração	Distância	Resultado
geofenceRadiusMeters: 0	qualquer	sem validação
geofenceRadiusMeters: 200	≤ 200m	check-in aprovado
geofenceRadiusMeters: 200	200m–300m	check-in aprovado + geofenceStatus: "alerta"
geofenceRadiusMeters: 200	> 300m	check-in bloqueado (fora_do_geofence)

A faixa de alerta é 50% extra do raio configurado. O bloqueio ocorre a partir de 150% do raio.

---

Configurar geofence no tenant

cURL

curl -X PATCH https://api.velixbiometrics.com/v1/tenants/$TENANT_ID/settings \
  -H "Authorization: Bearer $VELIX_API_KEY" \
  -d '{
    "geofenceRadiusMeters": 200
  }'

---

Enviar coordenadas no check-in

As coordenadas GPS devem ser enviadas no payload do check-in:

{
  "method": "facial",
  "frame": "BASE64...",
  "lat": -23.5505,
  "lng": -46.6333
}

Se as coordenadas não forem enviadas e o geofence estiver ativo, o check-in é processado com aviso de GPS indisponível.

---

Resposta com alerta

{
  "success": true,
  "personId": "person_xyz",
  "geofenceStatus": "alerta",
  "geofenceDistanciaMetros": 245
}

O evento checkin.geofence_alert também é disparado via webhook para notificar o supervisor.