Obtém informações relacionadas a localização de um dispositivo mobile, como latitude e longitude.

Image Added

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 as 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 grau 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.
• item.coords.heading: Direção de viagem, especificada em graus contada no sentido horário em relação ao norte verdadeiro.
• item.coords.speed: Velocidade atual do dispositivo no solo, especificada em metros por segundo.
• item.coords.timestamp: Hora atual local.

Parâmetros

Sucesso

Executa uma ação caso o diretório a geolocalização seja criado obtida com sucesso.

• 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 criação do diretórioobtençã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 destes blocos, inserimos a variável "item", e no parâmetro Propriedade inserimos "coords.latitude", em um bloco e no outro "coords.longitude".

bloco Ler Arquivo. O bloco Exibir Notificação retornará uma mensagem a depender do resultado da leitura do arquivo. Caso ocorra com sucesso, o fluxo de execução é direcionado para os comandos contidos no parâmetro Sucesso, caso contrário, os comandos em Erro são executados.

Image Added

Figura 2 - Exemplo de uso do bloco Ler ArquivoObter Georreferenciamento

A imagem a seguir mostra o resultado de execução da função da Figura 2. Após clicar no botão "Ler arquivo", a função será executada <TODO> Na imagem, vemos a notificação exibida após esta ação.

Figura 2.1 - Resultado de execução da função da Figura 2