Geolocalización

Muestra la ubicación de un usuario en un mapa en lugar de una ubicación estática. Se puede utilizar con las vistas Mapa y API de OpenLayers.

Puede utilizar esta vista conjuntamente con las vistas 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. Ubicación es una variable de contexto, que está disponible dentro del suceso On Location Resolved de esta vista.

Para que funcione esta vista, 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, la vista 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 la vista Geocodificador, la vista 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 la vista API OpenLayers en la parte superior de la página o, por lo menos, antes de la vista Mapa. Para obtener más información, consulte Mapa y API OpenLayers.

Propiedades de configuración

En la tabla siguiente se enumeran las propiedades de configuración de la vista 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 la vista: Una vez al cargar, Continuo, Inicialmente detenido.	`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`
Timeout	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 la vista API OpenLayers para especificar una clave de API.
Utilice la vista Geolocalización para encontrar la ubicación del usuario y mostrarla en el mapa.
Utilice la vista Geocodificador para mostrar una dirección física en una vista de texto, como por ejemplo una Nota, un Texto de salida, un Texto u otros.
Añada la vista Mapa a la página y ajuste las propiedades de aspecto según corresponda.

Añada una vista HTML personalizado para que la vista Mapa comunique las coordenadas al mapa.

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

     //Setting the center of the map and adding a marker
     map.setCenter(location.latitude, location.longitude);
     map.addMarker();

     // <optional> Printing the Coordinates to the Coordinates field 
     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): La vista Geolocalización llama a esta funció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 tal como se muestra en el siguiente mapa.

Métodos

Para obtener información detallada sobre los métodos disponibles para Geo location, consulte la API de Geo location JavaScript .

Recursos adicionales

Para obtener información sobre cómo crear un coach o una página, consulte Creación de coaches.
Para obtener información sobre las propiedades estándar (General, Configuración, Posicionamiento, Visibilidady Atributos HTML), consulte Ver propiedades.

Para obtener información sobre las vistas geográficas asociadas, consulte Geolocalización, Mapay APIOpenLayers.