Geofocagem
Nesta página
O geofencing restringe o desbloqueio às pessoas que estão fisicamente perto da instalação. Quando habilitado, o aplicativo móvel precisa informar uma localização dentro do círculo configurado antes que um desbloqueio seja permitido — impedindo que alguém abra uma porta de casa. Configure a geofence da instalação em Settings → Geofencing; os escopos e as portas individuais podem substituí-la.


Figura 1: O editor da geofence da instalação
Como a verificação funciona
Quando um usuário toca em desbloquear, o telefone envia a localização atual e a precisão do GPS. O servidor (e não o telefone) decide:
- Nenhuma localização informada → negado — o usuário é solicitado a ativar os serviços de localização. (Motivo: localização indisponível)
- GPS impreciso demais — a precisão da leitura é pior que o limite Require GPS accuracy better than → negado. Isso impede que leituras pouco confiáveis (por exemplo, em ambientes internos com sinal fraco) sejam aceitas. (Motivo: GPS impreciso demais)
- Verificação de distância — a distância do usuário até o centro da geofence deve estar dentro de: raio + precisão do GPS informada + margem de precisão. Fora disso → negado, e o aplicativo sugere que o usuário se aproxime. (Motivo: fora da geofence)
- Dentro → a verificação da geofence é aprovada e o restante da decisão de acesso continua.
Como a precisão do GPS é somada à tolerância, um usuário parado no limite com precisão de ±15 m ainda é aprovado — a verificação foi projetada para evitar negações falsas causadas pelo ruído normal do GPS, mantendo os desbloqueios remotos bloqueados. A decisão é tomada no servidor, portanto um aplicativo adulterado ou uma localização falsificada continua sendo rejeitado.
Se o geofencing estiver habilitado, mas o pino/centro estiver ausente, os desbloqueios serão negados (o sistema falha de forma fechada) — sempre confirme que o pino está posicionado.
Configurações
| Configuração | Padrão | Intervalo | O que faz |
|---|---|---|---|
| Require user to be at facility (geofence) | Ativada para novas configurações de instalação | Ativada / Desativada | Chave geral. Quando desativada, mostra: "Geofence is disabled — anyone with credentials can open the door from anywhere." |
| Radius | 200 m | 50–5000 m (controle deslizante, incrementos de 10 m; predefinições 50/200/500/1000 m) | O círculo ao redor do pino no qual os desbloqueios são permitidos |
| Accuracy buffer (m) | 25 m | — | Metros extras somados à tolerância para tolerar o ruído normal do GPS |
| Require GPS accuracy better than (m) | 100 m | — | As leituras com precisão pior que este valor são rejeitadas de imediato |
Como posicionar o pino
- Arraste o pino até o centro da sua instalação ou use Search address ("Start typing a street address…") para soltá-lo em um endereço.
- Reset to facility location devolve o pino às coordenadas do endereço salvo da instalação. Um chip Pin manually placed aparece quando o pino foi afastado do local salvo.
- Avisos aparecem se a instalação não tiver endereço cadastrado (com um link para Configuração de instalações e sistemas; consulte Localização da instalação) ou se o pino estiver a mais de 500 m do local salvo da instalação — ambos geralmente significam que o endereço da instalação precisa ser atualizado.
Como testar a geofence
Clique em Test Geofence para entrar no modo de teste: um pino roxo T aparece no mapa. Arraste-o para qualquer ponto para simular um usuário desbloqueando a partir dali — o editor mostra imediatamente Would pass ou Would be denied, com o motivo e a distância. Clique em Stop testing para sair. Use esse recurso para conferir o raio antes de salvar, por exemplo, confirmando que o estacionamento está dentro, mas o café do outro lado da rua não.
Hierarquia de substituição
A geofence da instalação se aplica a todas as portas por padrão. Dois níveis podem substituí-la; o mais específico prevalece:
| Nível | Onde | Opções |
|---|---|---|
| Escopo de acesso | Settings → Access Scopes → escopo → guia Geofence | Chave Geofence override + o próprio editor completo |
| Porta | Doors → painel da porta → guia Geofence | Inherit from facility / Override for this door / Disable geofence for this door |
As substituições por porta prevalecem sobre as substituições de escopo, que prevalecem sobre o padrão da instalação. Desativar a geofence de uma única porta é útil para entradas de serviço ou de bastidores, nas quais a equipe costuma desbloquear ainda fora do local. Cada cartão de porta na guia Doors mostra a geofence efetiva (raio ou Off, com · Override quando é específica da porta).
O que os membros veem
Quando ocorre uma negação por geofence, o aplicativo a explica em vez de falhar silenciosamente:
| Situação | Comportamento do aplicativo |
|---|---|
| Fora da geofence | Mensagem do tipo "aproxime-se", com a distância |
| GPS impreciso demais | Solicitação para sair ao ar livre / obter uma localização GPS mais nítida |
| Serviços de localização desativados | Solicitação para ativar as permissões de localização do aplicativo |
Todas as negações por geofence são registradas nos Registros de acesso com o motivo e (quando disponível) a distância — útil ao investigar relatos do tipo "não me deixa entrar".
Páginas relacionadas
- Como funcionam as decisões de acesso
- Portas — guia de geofence por porta
- Escopos de acesso — substituição no nível do escopo
- Solução de problemas — passo a passo para negações por geofence