Obtém de forma contínua a localização geográfica atual de um dispositivo móvel quando uma mudança de posição é detectada ou informações de localização do dispositivo móvel, detectada em um intervalo de tempo definido. Para interromper a obtenção contínua da localização utilize o bloco Parar Observador de Posição.

Figura 1 - Bloco Observar Posição

Compatibilidade

• Bloco cliente mobile: cronapi.cordova.geolocation.watchPosition()

Retorno

Retorna um valor string contendo um ID que representa a mudança de posição observada. Esse ID pode ser utilizado como parâmetro do bloco  Parar Observador de Posição para  para fazer com que a contínua observação da posição do dispositivo seja interrompida.

Parâmetros

Sucesso

Caso a geolocalização seja obtida com sucesso, o fluxo de execução é direcionado para os comandos contidos no parâmetro Sucesso, atribuindo a variável definida neste parâmetro um objeto contendo a localização geográfica do dispositivo.

• Posição: 1
• Inglês: Success
• Tipo: Comando com retorno ("item") / Command with return ("item")
• Exemplo: é possível utilizar um bloco de programação Exibir Notificação para exibir uma mensagem.

Erro

Caso a obtenção da geolocalização seja mal sucedida, os comandos em Erro são executados.

• Posição: 2
• Inglês: Error
• Tipo: Comando  Comando com retorno ("item") / Command with return ("item")
• Exemplo: é possível é possível utilizar um bloco de programação Exibir Notificação para exibir uma mensagem.

Tempo Máximo 

Parâmetro opcional. Aceita uma posição armazenada em cache cujo tempo não seja maior do que o tempo especificado em milissegundos.

• Posição: 3
• Inglês: Maximum Age
  
• Tipo: Inteiro / Integer 
• Exemplo: 3000

Intervalo

Parâmetro opcional. Período máximo de tempo, em milissegundos, para que a localização atual do dispositivo seja atualizada.

• Posição: 4
• Inglês: Time Out
  
• Tipo: Inteiro / Integer 
• Exemplo: 5000

Habilitar Alta Precisão

Parâmetro opcional. Por padrão, o dispositivo tenta recuperar uma posição usando métodos baseados em rede. Definir esta propriedade como verdadeira diz a função para usar métodos mais precisos, como o posicionamento via satélite. Neste parâmetro pode ser utilizado o bloco de valor booleano.

• Posição: 5
• Inglês: Enable High Accuracy
  
• Tipo: Boleano / Boolean 
• Exemplo: "verdadeiroverdadeiro"

Características do bloco

A função Observar Posição retorna um objeto JSON contendo propriedades relacionadas as coordenadas geográficas do dispositivo. Utilizando Utilize o bloco Obter Propriedade e considerando o objeto chamado Item, tem-se: para obter os atributos do objeto:

• Item.coords.latitude:  Distância distância de qualquer ponto da terra em relação ao Equador, medida em grau no meridiano desse ponto  (Número);.I
• tem.coords.longitude: Distância, medida em graus, entre um ponto qualquer da superfície terrestre e o meridiano distância de qualquer ponto da terra em relação ao meridiano de Greenwich, medida em grau (Número). 
• de Greenwich (Número);Item.coords.altitude:  Distância distância vertical medida entre um ponto e uma uma superfície de referência, geralmente o nível médio do mar mar (Número); .
• Item.coords.accuracy:  Nível nível de precisão das coordenadas de latitude e longitude em metros (Número);.Item.
• coords.altitudeAccuracy:  Nível nível de precisão da coordenada de altitude em metros (Número);.
• Item.coords.heading:  Direção direção de viagem, especificada em graus contada no sentido horário em relação ao norte verdadeiro (Número);.Item.
• coords.speed:  Velocidade velocidade atual do dispositivo no dispositivo no solo, especificada em metros por segundo (Número);.
• Item.timestamp: Carimbo carimbo de data/hora que indica quando as informações de localização foram obtidas (Número).

Exemplo

A função abaixo em destaque obtém do dispositivo a localização geográfica a cada 5000 milissegundos. Essa localização é obtida através de métodos mais precisos já que o parâmetro "Habilitar Alta Precisão" recebe o valor booleando Verdadeiro. Essas coordenadas geográficas são atribuídas a variável item, que passaa ter todas as propriedades contidas no objeto retornado pela função e que podem ser utilizadas pela aplicação, como por exemplo coords.latitude e coords.longitude.

Figura 2 - Função que exibe a latitude e longitude de uma posição 

O resultado da execução da figura 2 pode ser observado abaixo. Inicialmente o aplicativo solicitará permissão de localização do dispositivo, para, em seguida, exibir as coordenadas.

Image Modified

Figura 3 2.1 - Solicitação de permissão para localização do dispositivo 

Após escolher entre as duas primeiras opções (figura 32.1), o resultado será exibido, confira na figura 32.12.

Image Modified

Figura 32.1 2 - Resultado da execução da função da figura 2