Page tree
Skip to end of metadata
Go to start of metadata

Obter georreferenciamento

Retorna a localização geográfica atual de um dispositivo móvel.

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.

 

Compatibilidade

 Cliente

Exemplo 1

A função abaixo em destaque obtém do dispositivo a localização geográfica e a atribui a variável Item. Essa variável 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.latitude 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 Obter georreferenciamento 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

Atenção

coords.altitudeAccuracy: Esta propriedade não é suportada por dispositivos Android, ela sempre retornará nulo. 

 

 

 

 

 

  • No labels