Obtém informações relacionadas a localização de um dispositivo mobile, como latitude, longitude, altitude, entre outras. Para usar este bloco móvel. Esse bloco necessita que a configuração de localização do dispositivo deve estar móvel esteja ativada.
Figura 1 - Bloco Obter Georreferenciamento
| Dica |
|---|
| Utilize o bloco Observar posição para obter informações de forma continua. |
| 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.getCurrentPosition()
Âncora retorno retorno
Retorno
Retorna um objeto JSON contendo propriedades relacionadas às as coordenadas geográficas do dispositivo. No bloco, considerando o objeto como "item", pode-se obter as seguintes propriedades:Utilize o bloco Obter Propriedade para obter os atributos do objeto:
- item.coords.latitude: Distância distância de qualquer ponto da terra em relação ao Equador, medida em graus no meridiano desse pontograu (Número).item.
- coords.longitude: Distância, medida em graus, entre um ponto qualquer da superfície terrestre e o meridiano de Greenwich. distância de qualquer ponto da terra em relação ao meridiano de Greenwich, medida em grau (Número).
- item.coords.altitude: Distância 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).item.
- coords.accuracy: Nível nível de precisão das coordenadas de latitude e longitude em metros (Número).
- item.coords.altitudeAccuracy: Nível 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. item.
- coords.heading: Direção direção de viagem, especificada em graus contada no sentido horário em relação ao norte geográficoverdadeiro (Número).
- item.coords.speed: Velocidade velocidade atual do dispositivo no solo, especificada em metros por segundo (Número).
- item.timestamp: Carimbo 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
Âncora exemplo exemplo
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
| Informações |
|---|
Para testar a aplicação corretamente, será necessário compilar e instalar o aplicativo no dispositivo móvel. 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", a função será executada e 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
| Índice |
|---|