Skip to end of metadata
Go to start of metadata

Observar Posição

Obtém a localização geográfica atual de um dispositivo móvel quando uma mudança de posição é detectada ou em um intervalo de tempo definido.

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 pode apresentar 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.

Parâmetros

NomeTipoDoc
Parâmetro 1ComandoCaso 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 um objeto contendo a localização geográfica do dipositivo.
Parâmetro 2

Comando

(Opcional)

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

Parâmetros Opcionais

A função contém parâmetros opcionais utilizados para personalizar a obtenção da geolizalização do dispositivo.

NomeTipoDoc
Parâmetro 3 (Tempo Máximo)Inteiro

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

Parâmetro 4 (Intervalo)InteiroPeríodo máximo de tempo, em milissegundos, para que a localização atual do dispositivo seja atualizada.
Parâmetro 5 (Habilitar Alta Precisão)BooleanoPor 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.

 

Retorno

Retorna um valor string contendo um ID que representa a mudança de posição observada.

Obs.:

Esse ID pode ser utilizado como parâmetro da função Parar Observador de Posição para fazer com que a contínua observação da posição do dispositivo seja interrompida.

Compatibilidade

 Cliente

Exemplo 1

A função abaixo em destaque obtém do dispositivo a localização geográfica a cada 3000 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 passa a ter todas as propriedades contidas no objeto retornado pela função e que podem ser utilizadas pela aplicação, como por exemplo coords.longitude e coords.longitude.


 

Sobre geolocalização

A geolocalização é a localização de um objeto ou usuário em um sistema determinado de coordenadas. O processo de determinar geolocalização pode ser feito por uma série de tecnologias e, geralmente, quando se fala de geolocalização de um usuário, refere-se a um smartphone ou tablet sendo utilizado.

Mais sobre

 

Retorno da função: Propriedades do objeto

A função Observar Posição retorna um objeto contendo propriedades relacionadas as coordenadas geográficas do dispositivo. Considerando o objeto chamado Item, tem-se:

 Clique aqui pra expandir as opções

Item.coords.latitudeDistância de qualquer ponto da terra ao Equador medida em grau no meridiano desse ponto (Número);

Item.coords.longitude: Distância, medida em graus, entre um ponto qualquer da superfície terrestre e o meridiano de Greenwich (Número);

Item.coords.altitudeDistância vertical medida entre um ponto e uma uma superfície de referência, geralmente o nível médio do mar (Número); 

Item.coords.accuracy: Nível de precisão das coordenadas de latitude e longitude em metros (Número);

Item.coords.altitudeAccuracy: Nível de precisão da coordenada de altitude em metros (Número);

Item.coords.heading: Direção de viagem, especificada em graus contada no sentido horário em relação ao norte verdadeiro (Número);

Item.coords.speed: Velocidade atual do dispositivo no solo, especificada em metros por segundo (Número);

Item.coords.timestamp: Hora atual local

 

 

  • No labels