Determinar la ubicacin fsica del usuario se ha vuelto crtico en aplicaciones web

modernas. El reciente xito de los

dispositivos mviles ofrece nuevas posibilidades para crear aplicaciones que
aprovechan esta informacin.
Mtodos
La API Geolocation provee tres mtodos para obtener la ubicacin de un dispositivo:
getCurrentPosition(ubicacin, error, configuracin) Este mtodo retorna informacin
sobre la ubicacin del
dispositivo que est accediendo a la aplicacin. El primer atributo es una funcin
destinada a procesar la
informacin, el segundo atributo es otra funcin para procesamiento de errores, y el
tercer atributo es un objeto
con valores de configuracin (vea Objeto Configuracin debajo).
watchPosition(ubicacin, error, configuracin) Este mtodo retorna informacin sobre la
ubicacin del
dispositivo que est accediendo a la aplicacin cada vez que la ubicacin cambia. El
primer atributo es una
funcin destinada a procesar la informacin, el segundo atributo es otra funcin para
procesamiento de
errores, y el tercer atributo es un objeto con valores de configuracin (vea Objeto
Configuracin debajo).
clearWatch(id) Este mtodo cancela el proceso que ha sido empezado por el mtodo
watchPosition(). El
atributo id es el valor de identificacin retornado por el mtodo watchPosition() cuando
es llamado.
Objetos
Los mtodos getCurrentPosition() y watchPosition() generan dos objetos para
comunicar la informacin
retornada por el sistema de ubicacin y el estado de la operacin.
Objeto Position Este objeto es generado para contener la informacin acerca de la
ubicacin detectada. Tiene
dos atributos: coords y timestamp.
coords Este es un atributo del objeto Position. Tiene siete atributos internos para
retornar la informacin de la
ubicacin: latitude (latitud), longitude (longitud), altitude (altitud en metros), accuracy
(exactitud en
metros), altitudeAccuracy (exactitud de la altitud en metros), heading (direccin en
grados) y speed (velocidad
en metros por segundo).
timestamp Este es un atributo del objeto Position. Retorna el momento en el que la
ubicacin fue detectada.
Objeto PositionError Este objeto es generado cuando un error ocurre. Ofrece dos
atributos generales con el valor
y el mensaje del error, y tres valores especficos para identificacin de errores
individuales (listados debajo).
message Este es un atributo del objeto PositionError. Retorna un mensaje describiendo
el error detectado.

error Este es un atributo del objeto PositionError. Contiene el valor del error detectado.
Los posibles valores
son listados debajo:
PERMISSION_DENIED (permiso denegado) - valor 1 en el atributo error. Esta
constante es true (verdadero)
cuando el usuario no permite a la aplicacin acceder a la informacin sobre su
ubicacin.
POSITION_UNAVAILABLE (ubicacin no disponible) - valor 2 en el atributo error. Esta
constante es true
(verdadero) cuando la ubicacin del dispositivo no puede ser determinada.
TIMEOUT (tiempo excedido) - valor 3 en el atributo error. Esta constante es true
(verdadero) cuando la ubicacin
no puede ser determinada antes del periodo de tiempo declarado en la configuracin.
El siguiente objeto es requerido por los mtodos getCurrentPosition() y watchPosition()
para propsitos de
configuracin.
Objeto Configuracin Este objeto provee valores de configuracin correspondientes
para los mtodos
getCurrentPosition() y watchPosition().
enableHighAccuracy Esta es una de las posibles propiedades del Objeto Configuracin.
Si es declarada como
true (verdadero), le solicitar al navegador obtener la ubicacin ms precisa posible.
timeout Esta es una de las propiedades del Objeto Configuracin. Indica el mximo
tiempo disponible que tiene
la operacin para realizarse.
maximumAge Esta es una de las propiedades del Objeto Configuracin. Indica por
cunto tiempo la ltima
ubicacin detectada ser vlida.