Compartilhar via


Windows.Devices.Geolocation.Geofencing Namespace

Uma cerca geográfica é uma área virtual em torno de um ponto geográfico. As APIs de cerca geográfica permitem que os aplicativos forneçam experiências geograficamente contextuais em tempo hábil sem a necessidade de o aplicativo estar executando e consumindo continuamente os recursos do dispositivo. A cerca geográfica permite cenários como abrir um lembrete para um usuário quando ele está saindo do trabalho ou de casa ou exibindo cupons quando o usuário está dentro do intervalo de um repositório.

Os aplicativos definem áreas de interesse (cercas geográficas) e condições de gatilho correspondentes, como disparar quando o usuário entra ou sai da cerca geográfica. Por fim, o aplicativo se registra para ser notificado quando as condições de gatilho são atendidas. O Windows e o Windows Phone dão suporte a centenas de cercas geográficas por aplicativo. O sistema operacional gerencia com eficiência o acompanhamento de cerca geográfica para todos os aplicativos. Quando as condições de gatilho para uma ou mais cercas geográficas são atendidas, o aplicativo associado é alertado mesmo quando não está em execução ativamente. Esse sistema de acompanhamento de cerca geográfica adaptável, com alta capacidade, com reconhecimento de energia, permite que você adicione funcionalidades disparadas por localização de forma rápida e fácil ao seu aplicativo.

Para obter um guia completo sobre como usar o isolamento geográfico, consulte Cerca geográfica, comece a concluir.

As APIs de cerca geográfica permitem que seu aplicativo faça o seguinte:

  • Crie uma ou mais cercas geográficas ou áreas de interesse.
  • Solicitação para ser notificado quando o dispositivo insere uma cerca geográfica.
  • Solicitação para ser notificado quando o dispositivo sair de uma cerca geográfica.
  • Especifique uma janela de tempo durante a qual a cerca geográfica está ativa.
  • Especifique um tempo de espera para cada cerca geográfica – a quantidade de tempo em que o dispositivo deve estar dentro ou fora da cerca geográfica antes que a notificação seja disparada.
  • Adicione e remova dinamicamente uma cerca geográfica da coleção de cercas geográficas monitoradas do seu aplicativo.
  • Receber eventos de cerca geográfica enquanto o aplicativo estiver ativo.
  • Registre-se no sistema para que uma tarefa em segundo plano seja iniciada quando o estado de uma das cercas geográficas do aplicativo for alterado. Os aplicativos devem chamar RequestAccessAsync antes que as tarefas em segundo plano sejam executadas.
  • Use o simulador para simular a movimentação do dispositivo e testar os recursos de cerca geográfica do aplicativo.

Se você quiser que seu aplicativo seja iniciado em segundo plano quando a condição de gatilho para uma de suas cercas geográficas for atendida, você precisará usar uma tarefa em segundo plano e configurar um LocationTrigger para iniciá-lo.

Importante

A partir do Windows 10, chame o método RequestAccessAsync do objeto Geolocator antes de acessar a localização do usuário. Nesse momento, seu aplicativo deve estar em primeiro plano e RequestAccessAsync deve ser chamado do thread da interface do usuário. Até que o usuário conceda permissão ao aplicativo para acessar sua localização, seu aplicativo não poderá acessar dados de localização.

Classes

Geofence

Contém a funcionalidade para definir uma cerca geográfica (uma área geográfica de interesse) a ser monitorada.

GeofenceMonitor

Contém as informações sobre os objetos Geofence monitorados.

GeofenceStateChangeReport

Contém as informações sobre as alterações de estado de uma cerca geográfica.

Enumerações

GeofenceMonitorStatus

Indica o estado atual de um GeofenceMonitor.

GeofenceRemovalReason

Indica o motivo pelo qual uma cerca geográfica foi removida.

GeofenceState

Indica o estado atual de uma cerca geográfica.

MonitoredGeofenceStates

Indica o estado ou os estados das cercas geográficas que estão sendo monitoradas pelo sistema no momento.

Comentários

Os serviços de localização devem estar em execução para que a cerca geográfica funcione. Se esse serviço estiver desabilitado, as chamadas de cerca geográfica falharão e lançarão uma exceção.

Seu aplicativo deve declarar a funcionalidade de localização no manifesto do aplicativo para usar o isolamento geográfico.