Obtém a mais recente coordenada de geolocalização disponibilizada pelo dispositivo móvel.
Sintaxe
GetGeoCoordinate( [ nFormat ] )
Parâmetros
Nome | Tipo | Descrição | Obrigatório | Referência |
---|---|---|---|---|
nFormat | numérico | Valor correspondente ao formato da coordenada desejado. 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
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 cCoordinates := oMbl:GetGeoCoordinate(GEOCOORDINATE_DEGREESMINUTESHEMISPHERE)