VGPS - Documentación de Velneo

Esta clase representa la localización GPS de dispositivos móviles.
Las funciones de esta clase son funcionales únicamente en en Android y en iOS.
Requiere importarla previamente a su uso:
importClass ( "VGPS" );
El objeto theGps representa al geoposicionador del dispositivo móvil y nos permite acceder a la información de geolocalización.
Funciones
De gestión
Retorno
Función
Boolean
​start( nModo, nInterval )
Void
​stop()
De información
Retorno
Función
Number
​altitude()
Number
​direction()
Number
​horizontalAccuracy()
Number
horizontalSpeed()
Number
​latitude()
Number
​longitude()
Number
​mode()
Int
​satellites()
Int
satellitesInView()
dateTime
​timeStamp()
Number
​verticalAccuracy()
Number
verticalSpeed()
Enumeraciones
Modos de GPS
GPSAll = 0                                                                                                                                                                                         
GPSSatellites = 1
GPSWiFi = 2 
Documentación de funciones
Funciones de gestión
Boolean start( nModo, nInterval )
Inicia la localización GPS del dispositivo.
Devuelve true si la operación ha finalizado correctamente o false en caso de que se haya producido un error. 
Parámetros:
nModo: permite indicar el modo de GPS. Ver enum de modos de GPS.
nIterval: permite establecer un intervalo de actualización de la localización. Si lo dejamos vacío o le ponemos un valor 0 el intervalo la fuente a la que se esté conectado actualizará tan a menudo como sea necesario. Dependerá directamente de la calidad de la conexión. 
Podemos configurar en el marco una conexión de evento que se dispare cada vez que se actualice la geoposción mediante la señal geoposición actualizada.
void stop()
Detiene la localización GPS del dispositivo.
Funciones de información
Number altitude()
Devuelve un número con la altitud de la posición GPS.
Number direction()
Devuelve un número con la dirección de la posición GPS.
Number horizontalAccuracy()
Devuelve un número con la posición horizontal GPS.
Number horizontalSpeed()
Devuelve un número con la velocidad horizontal  GPS.
Number latitude()
Devuelve un número con la latitud de la posición GPS.
Number longitude()
Devuelve un número con la longitud de la posición GPS.
Number mode()
Devuelve un número con el modo de GPS utilizado. Los valores posibles son:
0 (Todos).
1 (Satélite: para el posicionamiento hace uso de la información de satélites GPS).
2 (Celdas/Wifi).
int satellites()
Devuelve un número entero con el número de satélites en uso.
Int satellitesInView()
Devuelve un número entero con el número de satélites en vista.
dateTime timeStamp()
Devuelve en un dato de tipo tiempo la fecha/hora UTC de la operación.
Number verticalAccuracy()
Devuelve un número con la posición vertical GPS.
Number verticalSpeed()
Devuelve un número con la velocidad vertical GPS.
​
Ejemplos
1. Iniciar el GPS, obtiene la posición y devolver un mensaje con todos los datos
1
importClass("VGPS") 
2
​
3
var iniciado = theGps.start(0, 5);
4
​
5
if (iniciado) {
6
 var fecha = new Date(theGps.timeStamp());
7
 var latitud = theGps.latitude();
8
 var altitud = theGps.altitude();
9
 var direccion = theGps.direction();
10
 var horizontal = theGps.horizontalAccuracy();
11
 var vertical = theGps.verticalAccuracy();
12
 var modo = theGps.mode();
13
 var satelites = theGps.satellites();
14
 alert("Fecha: " + fecha + "<br>" +
15
 "Latitud: " + latitud + "<br>" +
16
 "Altitud: " + altitud + "<br>" +
17
 "Dirección: " + direccion + "<br>" +
18
 "Horizontal: " + horizontal + "<br>" +
19
 "Vertical: " + vertical  + "<br>" +
20
 "Modo: " + modo + "<br>" +
21
 "Satélites: " + satelites);
22
}
23
else{
24
 alert("No se ha podido inicair el GPS");
25
}
Copied!