TOTVSTEC

Árvore de páginas

Habilita, desabilita e também parametriza o recebimento de coordenadas de geolocalização através do bloco de código bGeoCoordinateUpdate.

Sintaxe

EnableGeoCoordinateUpdate( [ nInterval ], [ nFormat ] )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

nInterval

numérico

Indica o tempo de intervalo mínimo em milissegundos entre as notificações de atualizações de coordenadas do dispositivo móvel ao bloco de código bGeoCoordinateUpdate. O valor 0 indica que o dispositivo móvel deve notificar o bloco de código bGeoCoordinateUpdate imediatamente e sempre que houver atualizações de coordenadas de geolocalização (isso pode elevar o uso da bateria). O valor -1 desativa a notificação de atualizações de coordenadas por parte do dispositivo móvel.

 

 

nFormat

numérico

Valor correspondente ao formato desejado da coordenada. Consulte a área de observações abaixo para conhecer os valores possíveis para este parâmetro.

 

 

Retorno

Nome

Tipo

Descrição

cCoordinates

caractere

Retorna uma cadeia de caracteres contendo as coordenadas em latitude e longitude no formato escolhido.

Observações

  • É recomendável ativar o recebimento de coordenadas somente quando necessário, e desativá-lo se possível visando a economia de bateria do dispositivo móvel.
  • O sistema de geolocalização deve estar ativado no dispositivo móvel.

Utilize um dos tipos abaixo no parâmetro nFormat:

Valor

Descrição

Exemplo

0

Formato em graus com fração decimal.

-23.50607°, -46.64371°

1

Formato em graus com fração decimal e letra para indicar hemisfério.

23.50607° S, 46.64376° W

2

Formato em graus com fração em minutos.

-23° 30.364', -46° 38.625'

3

Formato em graus com fração em minutos e letra para indicar hemisfério.

23° 30.365' S, 46° 38.626' W

4

Formato em graus com fração em minutos e segundos.

-23° 30' 21.9", -46° 38' 37.5"

5

Formato em graus com fração em minutos e segundos e letra para indicar hemisfério.

23° 30' 21.8" S, 46° 38' 37.5" W

Exemplos

  #define GEOCOORDINATE_DEGREES                         0
  #define GEOCOORDINATE_DEGREESHEMISPHERE               1
  #define GEOCOORDINATE_DEGREESMINUTES                  2
  #define GEOCOORDINATE_DEGREESMINUTESHEMISPHERE        3
  #define GEOCOORDINATE_DEGREESMINUTESSECONDS           4
  #define GEOCOORDINATE_DEGREESMINUTESSECONDSHEMISPHERE 5
  
  oMbl:EnableGeoCoordinateUpdate( 60000, GEOCOORDINATE_DEGREESMINUTESSECONDSHEMISPHERE )
  • Sem rótulos