Interrompe a obtenção contínua da localização geográfica de um dispositivo móvel.
Figura 1 - Bloco Parar Observador de Posição
Obs
A localização de dispositivos móveis pode ser obtida com base em diversas fontes, como por exemplo: Sistema de Posicionamento Global (GPS), localização inferida a partir de sinais de rede como endereço IP, RFID e WiFi. Não há garantia de que a função irá retornar a localização real do dispositivo.
Atenção
A coleta e uso de dados de geolocalização apresenta importantes problemas de privacidade. A política de privacidade da aplicação criada com essa função deve analisar a forma de uso dos dados de geolocalização, seja na forma de compartilhamento da informação ou em relação ao nível de precisão dos dados.
Compatibilidade
- Bloco cliente mobile: cronapi.cordova.geolocation.clearWatchPosition()
Retorno
O bloco não possui retorno.
Parâmetros
Identificação do observador
ID que representa a mudança de posição observada do dispositivo. Esse ID é o retorno da função Observar Posição, qualquer variável que esteja recebendo esse bloco pode ser utilizada nesse parâmetro.
- Posição: 1
- Inglês: Observer id
- Tipo: Texto / String
- Exemplo: retorno do bloco Observar Posição.
Exemplo
O bloco Parar Observador de Posição é utilizado em conjunto com o bloco Observar Posição. Separamos o exemplo em duas imagens, na figura 2 estamos obtendo a latitude e longitude de uma posição a cada 5 segundos. Com a ajuda do bloco Alterar valor do campo, atualizaremos seu resultado em um componente Entrada de Texto. Inserir o bloco Parar Observador de Posição na função "Example" faria com que a função não funcionasse corretamente, pois ela precisa ser acionada, por isso criamos uma variável de escopo chamada "Observacao", passando a variável "id" no parâmetro "Valor".
Figura 2 - Função Observar Posição
Criamos então a função "Example2". No parâmetro do bloco Parar Observador de Posição, adicionamos o bloco Obtém variável de escopo e nele inserimos a variável de escopo criada na função anterior (figura 2). Através dessa função conseguiremos parar a atualização constante dos dados no componente entrada de texto (figura 3).
Figura 2.1 - Função Parar Observação
O teste abaixo foi feito em sistema Android. Veja mais detalhes de como compilar aplicações para Android e iOS no tópico "Exportar e compilar projetos" na documentação Desenvolvimento mobile.
O resultado pode ser conferido abaixo. O primeiro botão recebe a função da figura 2 e o segundo recebe a função da figura 2.1. Lembre-se de vincular a página do bloco à view onde está o componente entrada de texto.
Figura 3 - Resultado da execução da função da figura 2 e 2.1
Nesta Página