API de geolocalizacin

Conceptos y uso

A menudo querr recuperar la informacin de ubicacin de un usuario en su aplicacin web, por ejemplo, para trazar su ubicacin en un mapa o mostrar informacin personalizada relevante para su ubicacin.

Se accede a la API de geolocalizacin a travs de una llamada a navigator.geolocation; esto har que el navegador del usuario le pida permiso para acceder a sus datos de ubicacin. Si aceptan, el navegador utilizar la mejor funcionalidad disponible en el dispositivo para acceder a esta informacin (por ejemplo, GPS).

El desarrollador ahora puede acceder a esta informacin de ubicacin de dos maneras diferentes:

• Geolocation.getCurrentPosition(): Recupera la ubicacin actual del dispositivo.
• Geolocation.watchPosition(): Registra una funcin de controlador que se llamar automticamente cada vez que cambie la posicin del dispositivo, devolviendo la ubicacin actualizada.

En ambos casos, la llamada al mtodo toma hasta tres argumentos.

• Una funcin obligatoria que ser llamada en caso de xito: si la recuperacin de la ubicacin es exitosa, la funcin se ejecuta con un objeto GeolocationPosition como su nico parmetro, proporcionando acceso a los datos de ubicacin.
• Una funcin opcional que ser llamada en caso de error: si la recuperacin de la ubicacin no tiene xito, la funcin se ejecuta con un objeto GeolocationPositionError como su nico parmetro, proporcionando informacin de acceso sobre lo que sali mal.
• Un objeto opcional que proporciona opciones para la recuperacin de los datos de posicin.

Para obtener ms informacin sobre el uso de la geolocalizacin, lea Uso de la API de geolocalizacin

Interfaces

Geolocation

La clase principal de esta API: contiene mtodos para recuperar la posicin actual del usuario, observar cambios en su posicin y borrar una observacin establecida previamente.

GeolocationPosition

Representa la posicin de un usuario. Una instancia de GeolocationPosition es devuelta por una llamada exitosa a uno de los mtodos contenidos dentro de Geolocation, dentro de una devolucin de llamada exitosa, y contiene una marca de tiempo ms una instancia de objeto GeolocationCoordinates.

GeolocationCoordinates

Representa las coordenadas de la posicin de un usuario; una instancia de GeolocationCoordinates contiene latitud, longitud y otra informacin relacionada importante.

GeolocationPositionError

Un GeolocationPositionError es devuelto por una llamada fallida a uno de los mtodos contenidos dentro de Geolocation, dentro de una devolucin de llamada de error, y contiene un cdigo y un mensaje de error.

Navigator.geolocation

El punto de entrada a la API. Devuelve una instancia de objeto Geolocation, desde la cual se puede acceder a todas las dems funciones.

Ejemplo

Consulte Uso de la API de geolocalizacin para obtener un cdigo de ejemplo.

Especificaciones

Compatibilidad con navegadores

Disponibilidad

Dado que Google suele proporcionar la ubicacin basada en Wi-Fi, es posible que la API vanilla de Geolocalizacin no est disponible en China. Puede utilizar proveedores externos locales como Baidu, Autonavi, o Tencent. Estos servicios utilizan la direccin IP del usuario y/o una aplicacin local para proporcionar un mejor posicionamiento.

Vase tambin

• Uso de la API de geolocalizacin
• API de geolocalizacin en w3.org
• Quin movi mi geolocalizacin? (Hacks blog)