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:
Alocalizaçã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.
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çãoParar Observador de Posiçãopara 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.