Esta página ha sido traducida del inglés por la comunidad.Aprende más y únete a la comunidad de MDN Web Docs.
API de geolocalización
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since julio de 2015.
Contexto seguro: Esta función está disponible solo encontextos seguros (HTTPS), en algunos o todos losnavegadores que lo soportan.
LaAPI de geolocalización permite al usuario compartir su ubicación a las aplicaciones web si así lo desea.Por razones de privacidad, al usuario se le pide que confirme el permiso para proporcionar información de ubicación.
LasWebExtensions que deseen utilizar el objetoGeolocation deben agregar el permiso"geolocation" a su manifiesto.El sistema operativo del usuario le indicará que permita el acceso a la ubicación la primera vez que se solicite.
Conceptos y uso
A menudo querrá recuperar la información de ubicación de un usuario en su aplicación web,por ejemplo, para trazar su ubicación en un mapa o mostrar información personalizada relevante para su ubicación.
Se accede a la API de geolocalización a través de una llamada anavigator.geolocation;esto hará que el navegador del usuario le pida permiso para acceder a sus datos de ubicación.Si aceptan, el navegador utilizará la mejor funcionalidad disponible en el dispositivo para acceder a esta información (por ejemplo, GPS).
El desarrollador ahora puede acceder a esta información de ubicación de dos maneras diferentes:
Geolocation.getCurrentPosition(): Recupera la ubicación actual del dispositivo.Geolocation.watchPosition(): Registra una función de controlador que se llamará automáticamente cada vez que cambie la posición del dispositivo, devolviendo la ubicación actualizada.
En ambos casos, la llamada al método toma hasta tres argumentos.
- Una función obligatoria que será llamada en caso de éxito: si la recuperación de la ubicación es exitosa, la función se ejecuta con un objeto
GeolocationPositioncomo su único parámetro, proporcionando acceso a los datos de ubicación. - Una función opcional que será llamada en caso de error: si la recuperación de la ubicación no tiene éxito, la función se ejecuta con un objeto
GeolocationPositionErrorcomo su único parámetro, proporcionando información de acceso sobre lo que salió mal. - Un objeto opcional que proporciona opciones para la recuperación de los datos de posición.
Para obtener más información sobre el uso de la geolocalización, leaUso de la API de geolocalización
Interfaces
GeolocationLa clase principal de esta API: contiene métodos para recuperar la posición actual del usuario, observar cambios en su posición y borrar una observación establecida previamente.
GeolocationPositionRepresenta la posición de un usuario. Una instancia de
GeolocationPositiones devuelta por una llamada exitosa a uno de los métodos contenidos dentro deGeolocation, dentro de una devolución de llamada exitosa, y contiene una marca de tiempo más una instancia de objetoGeolocationCoordinates.GeolocationCoordinatesRepresenta las coordenadas de la posición de un usuario; una instancia de
GeolocationCoordinatescontiene latitud, longitud y otra información relacionada importante.GeolocationPositionErrorUn
GeolocationPositionErrores devuelto por una llamada fallida a uno de los métodos contenidos dentro deGeolocation, dentro de una devolución de llamada de error, y contiene un código y un mensaje de error.Navigator.geolocationEl punto de entrada a la API. Devuelve una instancia de objeto
Geolocation, desde la cual se puede acceder a todas las demás funciones.
Ejemplo
ConsulteUso de la API de geolocalización para obtener un código de ejemplo.
Especificaciones
| Specification |
|---|
| Geolocation # geolocation_interface |
Compatibilidad con navegadores
Disponibilidad
Dado que Google suele proporcionar la ubicación basada en Wi-Fi, es posible que la APIvanilla de Geolocalización no esté disponible en China. Puede utilizar proveedores externos locales comoBaidu,Autonavi, oTencent. Estos servicios utilizan la dirección IP del usuario y/o una aplicación local para proporcionar un mejor posicionamiento.