HTML5 Geolocalización


HTML5 Geolocalización se utiliza para ubicar la posición del usuario.


Ubicar la posición del usuario

La API de Geolocalización de HTML5 se utiliza para obtener la ubicación geográfica del usuario.

Dado que esta característica puede infringir la privacidad del usuario, la información de ubicación del usuario no está disponible a menos que el usuario dé su consentimiento.


Compatibilidad del navegador

Internet ExplorerFirefoxOperaGoogle ChromeSafari

Internet Explorer 9+, Firefox, Chrome, Safari y Opera admiten Geolocalización.

Nota:La geolocalización es más precisa en dispositivos con GPS, como el iPhone.


HTML5 - Uso de la geolocalización

Utilice el método getCurrentPosition() para obtener la posición del usuario.

El siguiente ejemplo es un caso simple de geolocalización que devuelve la longitud y latitud de la posición del usuario:

Ejemplo

var x=document.getElementById("demo"); function getLocation() { if (navigator.geolocation) { navigator.geolocation.getCurrentPosition(showPosition); } else { x.innerHTML="Este navegador no admite la obtención de ubicación geográfica."; } } function showPosition(position) { x.innerHTML="Latitud:" + position.coords.latitude + "<br>Longitud:" + position.coords.longitude; }

Pruébalo »

Análisis del ejemplo:

  • Detectar si se admite la geolocalización
  • Si es compatible, se ejecuta el método getCurrentPosition(). Si no es compatible, se muestra un mensaje al usuario.
  • Si getCurrentPosition() se ejecuta correctamente, devuelve un objeto coordinates a la función especificada en el parámetro showPosition.
  • La función showPosition() obtiene y muestra la longitud y latitud.

El ejemplo anterior es un script de geolocalización muy básico, sin manejo de errores.


Manejo de errores y denegaciones

El segundo parámetro del método getCurrentPosition() se utiliza para manejar errores. Especifica la función que se ejecuta cuando falla la obtención de la posición del usuario:

Ejemplo

function showError(error) { switch(error.code) { case error.PERMISSION_DENIED: x.innerHTML="El usuario denegó la solicitud de geolocalización." break; case error.POSITION_UNAVAILABLE: x.innerHTML="La información de ubicación no está disponible." break; case error.TIMEOUT: x.innerHTML="Se agotó el tiempo de espera de la solicitud de ubicación del usuario." break; case error.UNKNOWN_ERROR: x.innerHTML="Error desconocido." break; } }

Pruébalo »

Códigos de error:

  • Permission denied - El usuario no permite la geolocalización
  • Position unavailable - No se puede obtener la posición actual
  • Timeout - La operación excedió el tiempo de espera

Mostrar el resultado en un mapa

Para mostrar el resultado en un mapa, necesita acceder a un servicio de mapas que pueda usar latitud y longitud, como Google Maps o Baidu Maps:

Ejemplo

function showPosition(position) { var latlon=position.coords.latitude+","+position.coords.longitude; var img_url="http://maps.googleapis.com/maps/api/staticmap?center=" +latlon+"&zoom=14&size=400x300&sensor=false"; document.getElementById("mapholder").innerHTML="<img src='"+img_url+"'>"; }

Pruébalo »

En el ejemplo anterior, usamos los datos de latitud y longitud devueltos para mostrar la ubicación en Google Maps (usando una imagen estática).

Script de Google Maps
El enlace anterior le muestra cómo usar el script para mostrar un mapa interactivo con marcadores, zoom y opciones de arrastre.


Información de una ubicación dada

Esta página demuestra cómo mostrar la posición del usuario en un mapa. Sin embargo, la geolocalización también es muy útil para obtener información de una ubicación dada.

Se puede utilizar para:

  • Actualizar información local
  • Mostrar puntos de interés alrededor del usuario
  • Sistema de navegación interactivo para vehículos (GPS)

Método getCurrentPosition() - Datos devueltos

Si tiene éxito, el método getCurrentPosition() devuelve un objeto. Siempre devuelve las propiedades latitude, longitude y accuracy. Si están disponibles, devuelve las otras propiedades a continuación.

Propiedad Descripción
coords.latitude Latitud en grados decimales
coords.longitude Longitud en grados decimales
coords.accuracy Precisión de la posición
coords.altitude Altitud, en metros sobre el nivel del mar
coords.altitudeAccuracy Precisión de la altitud de la posición
coords.heading Rumbo, en grados desde el norte verdadero
coords.speed Velocidad, en metros por segundo
timestamp Fecha/hora de la respuesta


Objeto Geolocation - Otros métodos interesantes

watchPosition() - Devuelve la posición actual del usuario y continúa devolviendo la posición actualizada cuando el usuario se mueve (como un GPS en un automóvil).

clearWatch() - Detiene el método watchPosition()

El siguiente ejemplo muestra el método watchPosition(). Necesita un dispositivo GPS preciso para probar este ejemplo (como un iPhone):

Ejemplo

var x=document.getElementById("demo"); function getLocation() { if (navigator.geolocation) { navigator.geolocation.watchPosition(showPosition); } else { x.innerHTML="Este navegador no admite la obtención de ubicación geográfica."; } } function showPosition(position) { x.innerHTML="Latitud:" + position.coords.latitude + "<br>Longitud:" + position.coords.longitude; }

Pruébalo »
Otras extensiones