Obtém informações relacionadas a localização de um dispositivo móvel. Esse bloco necessita que a configuração de localização do dispositivo móvel esteja ativada.
Figura 1 - Bloco Obter Georreferenciamento
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.
Compatibilidade
- Bloco cliente mobile: cronapi.cordova.geolocation.getCurrentPosition()
Retorno
Retorna um objeto JSON contendo propriedades relacionadas as coordenadas geográficas do dispositivo. Utilize o bloco Obter Propriedade para obter os atributos do objeto:
- coords.latitude: distância de qualquer ponto da terra em relação ao Equador, medida em grau (Número).
- coords.longitude: distância de qualquer ponto da terra em relação ao meridiano de Greenwich, medida em grau (Número).
- coords.altitude: distância vertical medida entre um ponto e uma uma superfície de referência, geralmente o nível médio do mar (Número).
- coords.accuracy: nível de precisão das coordenadas de latitude e longitude em metros (Número).
- coords.altitudeAccuracy: nível de precisão da coordenada de altitude em metros (Número). Esta propriedade não é suportada por dispositivos Android, ela sempre retornará nulo.
- coords.heading: direção de viagem, especificada em graus contada no sentido horário em relação ao norte verdadeiro (Número).
- coords.speed: velocidade atual do dispositivo no solo, especificada em metros por segundo (Número).
- timestamp: carimbo de data/hora que indica quando as informações de localização foram obtidas (Número).
Parâmetros
Sucesso
Executa uma ação caso a geolocalização seja obtida com sucesso. Neste parâmetro, também podem ser obtidas as propriedades relacionadas às coordenadas geográficas do dispositivo, mencionadas no tópico Retorno. Para isso, utilize o bloco Obter Propriedade conforme apresentado no Exemplo.
- Posição: 1
- Inglês: Success
- Tipo: Comando com retorno ("item") / Command with return ("item")
- Exemplo: uso do bloco Exibir Notificação
Erro
Executa uma ação caso ocorra um erro durante a obtenção da geolocalização.
- Posição: 2
- Inglês: Error
- Tipo: Comando com retorno ("item") / Command with return ("item")
- Exemplo: uso do bloco Exibir Notificação
Exemplo
A função abaixo mostra um exemplo de uso do bloco Obter Georreferenciamento. Essa função obtém a geolocalização do dispositivo e a atribui 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. Para obter essas propriedades, utilizamos os blocos Obter Propriedade, no parâmetro Objeto de cada bloco, inserimos a variável "item", e no parâmetro Propriedade, inserimos as propriedades "coords.latitude" em um bloco e "coords.longitude" no outro.
O bloco Exibir Notificação retornará uma mensagem a depender do resultado da obtenção das informações. Caso ocorra com sucesso, o fluxo de execução é direcionado para os comandos contidos no parâmetro Sucesso, onde as informações de latitude e longitude serão apresentadas, caso contrário, os comandos em Erro são executados.
Figura 2 - Exemplo de uso do bloco Obter Georreferenciamento
O teste abaixo foi feito em sistema Android. Veja mais detalhes de como compilar aplicações para Android e iOS no tópico "Exportar e compilar projetos" na documentação Desenvolvimento mobile.
A imagem a seguir mostra o resultado de execução da função da Figura 2. Após clicar no botão "Obter Georreferenciamento", o aplicativo inicialmente solicitará permissão de localização do dispositivo e, em seguida, as informações de latitude e longitude serão exibidas na tela.
Figura 2.1 - Resultado de execução da função da Figura 2
Nesta página