Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
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.
Informações | ||
---|---|---|
| ||
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. |
Aviso | ||
---|---|---|
| ||
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. |
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 da função Parar Observador de Posição 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 um objeto contendo a localização geográfica do dipositivo.
- 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 com retorno ("item") / Command with return ("item")
- Exemplo: é 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.
- Posição: 5
- Inglês: Enable High Accuracy
- Tipo: Boleano / Boolean
- Exemplo: Verdadeiro, Falso.