Obtém informações relacionadas a localização de um dispositivo mobile, como latitude, longitude, altitude, entre outras. Para usar este bloco a configuração de localização do dispositivo deve estar ativada.

Figura 1 - Bloco Obter Georreferenciamento

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.

Compatibilidade

• Bloco cliente mobile: cronapi.cordova.geolocation.getCurrentPosition()

Retorno

Retorna um objeto contendo propriedades relacionadas às coordenadas geográficas do dispositivo. No bloco, considerando o objeto como "item", pode-se obter as seguintes propriedades:

• item.coords.latitude: Distância de qualquer ponto da terra ao Equador medida em graus no meridiano desse ponto.
• item.coords.longitude: Distância, medida em graus, entre um ponto qualquer da superfície terrestre e o meridiano de Greenwich.
• item.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.
• item.coords.accuracy: Nível de precisão das coordenadas de latitude e longitude em metros.
• item.coords.altitudeAccuracy: Nível de precisão da coordenada de altitude em metros. Esta propriedade não é suportada por dispositivos Android, ela sempre retornará nulo. 
• item.coords.heading: Direção de viagem, especificada em graus contada no sentido horário em relação ao norte geográfico.
• item.coords.speed: Velocidade atual do dispositivo no solo, especificada em metros por segundo.
• item.timestamp: Carimbo de data/hora que indica quando as informações de localização foram obtidas.

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 "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

A imagem a seguir mostra o resultado de execução da função da Figura 2. Após clicar no botão "Obter Georreferenciamento", a função será executada e 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