Interrompe a obtenção contínua da localização geográfica de um dispositivo móvel iniciada a partir do bloco Observar posição.
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 funções, 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 na tela. Uma variável de escopo foi utilizada para armazenar o "id" de retorno do bloco Observar Posição, com isso, podemos a qualquer momento executar a função "Example2" (figura 2.1), passando o valor da variável de escopo no bloco Parar Observador de Posição.
Para esse exemplo, foi necessário vincular o bloco à view onde está o componente entrada de texto (ver mais detalhes em "Propriedades do Blockly" em Bloco de programação).
Figura 2 - Função Observar Posição
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 2.2).
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 executa a função da figura 2 e o segundo executa a função da figura 2.1.
Figura 2.2 - Resultado da execução da função da figura 2 e 2.1
Nesta Página