Geolocalización

Utilice la Geolocalización para mostrar la ubicación del usuario en un mapa, en lugar de una ubicación estática.

Puede utilizar este control conjuntamente con los controles Mapa y API OpenLayers. No obstante. puede que el control API OpenLayers no sea necesario, según el dispositivo. El contenido del objeto de ubicación y la precisión de estas métricas dependen del dispositivo en el que se ejecuta la interfaz de usuario. Independientemente del dispositivo, debe haber una latitud y una longitud disponibles a través de este objeto. La ubicación es una variable de contexto que está disponible mediante el suceso En ubicación resuelta de este control.

Para que funcione este control debe estar conectado a algún tipo de red de datos, como por ejemplo una red móvil, wifi, Ethernet o similar. Si no existe una conexión, el control no funciona. Como una función de seguridad incorporada del navegador, la página solicita permiso para acceder a la información de ubicación del usuario.

Al igual que el control Geocodificador, el control Geolocalización añade otra capa de información, permitiendo a los usuarios saber dónde se encuentran en un mapa. Puede utilizarlo para proporcionar un punto de referencia. Para una mejor eficiencia, primero ponga el control API OpenLayers en la parte superior de la página o, por lo menos, antes del control Mapa. Para obtener más información, consulte Correlación y API OpenLayers.

Propiedades de configuración

En la tabla siguiente se enumeran las propiedades de configuración del control Geolocalización:

Tabla 1. Propiedades de configuración para la Geolocalización
Propiedad de configuración	Descripción	Tipo de datos
Modalidad de supervisión	Modalidades de supervisión para el control: Una vez cargado, Continuo, Detenido inicialmente.	`GeoMonitoringMode`
Alta precisión	Si selecciona esta opción, la detección de ubicación es más precisa pero utiliza más energía de batería.	`Boolean`
Tiempo de espera	Puede especificar el número de milisegundos tras los cuales el dispositivo deja de intentar detectar la ubicación especificada. El valor predeterminado es 6000 ms.	`Integer`
Antigüedad máxima de datos	Puede especificar, en milisegundos, los datos de geolocalización más antiguos que se aceptarán. El valor predeterminado es 0 ms.	`Integer`

Ejemplo

En este ejemplo, seleccionará una clave de API para un mapa, localizará y visualizará una dirección, personalizará el aspecto del mapa comunicará la ubicación al mapa.

Utilice el control API OpenLayers para especificar una clave de API.
Utilice el control Geolocalización para encontrar la ubicación del usuario y mostrarla en el mapa.
Utilice el control Geocodificador para mostrar una dirección física en un control de texto, como por ejemplo una Nota, un Texto de salida, un Texto u otros.
Añada el control Mapa al coach y ajuste las propiedades de aspecto según corresponda.

Añada un control HTML personalizado para que el control Mapa comunique las coordenadas al mapa.

<script>
  function updateLocation(me, location){
     var map = page.ui.get("Map1");

     //Establecer el centro del mapa y añadir un marcador
     map.setCenter(location.latitude, location.longitude);
     map.addMarker();

     // <opcional> Imprimir las coordenadas en el campo Coordenadas 
     var coordinates= page.ui.get("Coordinates");
     coordinates.setText("Latitude: " + location.latitude +" "+"Longitude: "+

     location.longitude );
  }
</script>

Este código HTML se lee como se indica a continuación.

function updateLocation(me, location): A esta función la llama el control Geolocalización. El parámetro me hace referencia a Geo_Location1 y pasa información de ubicación.
var map = page.ui.get("Map1"): Esta función busca el mapa para habilitar la comunicación con el mismo.
map.setCenter(location.latitude, location.longitude): Esta función utiliza la información de ubicación que se ha pasado para establecer el centro del mapa a partir de los valores de los parámetros location.latitude y location.longitude.
map.addMarker(): Esta función añade un marcador a la ubicación centrada.
var coordinates= page.ui.get("Coordinates"): Esta función recupera el contenido del campo de texto Coordinadas.
coordinates.setText("Latitude: " + location.latitude +" "+"Longitude: "+ location.longitude ): Esta función establece el campo de texto con las coordenadas que se han encontrado.

El resultado muestra la ubicación del usuario como se muestra en el siguiente mapa

Métodos

Si desea información detallada sobre los métodos disponibles para la Geolocalización, consulte la API JavaScript Geolocalización.

Recursos adicionales

Para obtener información sobre cómo crear un coach, consulte Creación de coaches.
Para obtener información sobre las propiedades estándar (General, Configuración, Posicionamiento, Visibilidad y Atributos HTML), consulte Propiedades de vista de coach.

Para obtener información sobre los controles geográficos asociados, consulte Geolocalización, Correlación y API OpenLayers.