Mapa de geoubicación

www.altova.com Expandir/Contraer todos Imprimir este apartado Página anterior Subir un nivel Página siguiente

Inicio >  Controles y eventos de control > Controles >

Mapa de geoubicación

El control Mapa de geoubicación sirve para mostrar el mapa de un área concreta; puede escoger entre vista de calle, satélite o híbrida (la vista se define con la propiedad Tipo de mapa). Puede indicar los puntos de interés del área que engloba el mapa con marcadores. Puede agregar los marcadores que quiera con la propiedad Marcadores. Tiene la opción de incluir en el mapa la ubicación actual y controles de zoom (véanse más abajo las respectivas propiedades). El tamaño y la ampliación del mapa que aparecen inicialmente en el control se pueden definir con las propiedades Área de visualización, Ancho del control y Alto del control. El control Mapa de geoubicación también cuenta con un evento AlHacerClicEnGeomarcador, que permite definir acciones que ocurran si el usuario hace clic en uno de los marcadores.

 

Haga clic para expandir/contraerNotas
Cuando el control se asocia con un nodo de la fuente de datos (vínculo con la fuente de página), al pasar el cursor por el control (en la vista Diseño de páginas) aparece el nodo asociado.
Todos los vínculos con fuentes de página de la estructura de fuentes de página aparecen en negrita. Los nodos de la estructura que no son vínculos de fuente de página no están en negrita.
Al pasar el cursor por el vínculo con la fuente de página en la estructura del diseño aparece información sobre el control asociado.
Para eliminar una asociación con el nodo de la fuente de datos (y por tanto los datos del control) haga clic con el botón derecho en el control (en la vista Diseño de páginas) y haga clic en Eliminar vínculo con la fuente de la página.
Para restaurar un estilo o una propiedad (en el panel Estilos y propiedades), seleccione el estilo/la propiedad y haga clic en Restaurar en la barra de herramientas del panel.
Los valores de varias propiedades se pueden configurar usando expresiones XPath. Así podrá utilizar valores dinámicos, es decir, valores calculados o tomados de los nodos de la fuente de datos en tiempo de ejecución. Para crear una expresión XPath, haga clic en el botón Editar XPath de la barra de herramientas del panel Estilos y propiedades.
Para editar la expresión XPath de un estilo o de una propiedad (en el panel Estilos y propiedades), seleccione el estilo/la propiedad y haga clic en el botón Editar XPath de la barra de herramientas del panel.
Para copiar un control y pegarlo en otra ubicación del diseño, pulse Ctrl mientras arrastra el control hasta su nueva posición.
Para asignar propiedades a un control, defina clases para el control (con la propiedad Clase CSS del explorador) y después asigne reglas a las clases en un archivo CSS externo (que se elije en el cuadro de diálogo Configuración del explorador).
Las propiedades CSS de los controles se pueden definir en el panel Estilos y propiedades y en archivos CSS externos, pero las que se definan en el panel Estilos y propiedades tienen prioridad.

 

Eventos del mapa de geoubicación

Puede usar el evento AlHacerClicEnGeomarcador, que permite definir qué acciones ocurren si se hace clic en uno de los marcadores del mapa. Para obtener información sobre ese marcador puede usar la variable dinámica $MT_GeolocationMapMarker.

 

La variable dinámica $MT_GeolocationMapMarker muestra información sobre el último marcador en el que hizo clic el usuario del cliente. Esta información se almacena en una construcción XPath de asignación, en este formato:

 

map {

    "id":"vie",

    "geolocation":(48.2143531, 16.3707266),

    "title":"Vienna",

    "text":"Altova EU"

}

 

Para obtener un valor de la construcción XPath de asignación puede usar una expresión como esta: map:get( $MT_GeolocationMapMarker, "id" ). Esta expresión en concreto devuelve el valor de la clave id (es decir, la id del marcador en que se hizo clic).

 

Para ver qué acciones se pueden definir para el evento OnGeoMapMarkerClicked consulte el apartado Acciones.

 

Propiedades del mapa de geoubicación

Las propiedades del control se pueden editar y consultar en el panel Estilos y propiedades y se describen en este apartado por orden de aparición en el panel.

 

Click to expand/collapseNombre

Se utiliza para hacer referencia al control desde otras partes de la página o del proyecto. Haga doble clic dentro del campo de valor para editar esta propiedad.

 

Clic para expandir/contraerTipo de mapa

Indica el tipo de mapa que se muestra en el control Mapa de geoubicación. Las opciones son:

 

Predeterminado: usa el tipo de mapa que esté seleccionado en el dispositivo del cliente
Calle: muestra una vista de calle del área
Satélite: muestra una imagen de satélite del área
Híbrido: muestra una combinación de las vistas de calle y de satélite

 

Nota: también se puede usar una expresión XPath para indicar el tipo de mapa de forma dinámica. La expresión debe evaluar una de las siguientes propiedades: (i) calle, (ii) satélite, (iii) híbrido.

 

Nota: en clientes web y en el simulador solo hay un tipo de mapa disponible, independientemente cuál de las opciones anteriores seleccione.

 

Clic para expandir/contraerMostrar ubicación actual

Indica si se debe mostrar en el mapa la ubicación actual del dispositivo del cliente. Esto puede ser de ayuda para que los usuarios se ubiquen en el mapa. Los valores de la propiedad son true o false y el valor predeterminado es false. Para definir el valor de la propiedad de forma dinámica puede usar una expresión XPath (por ejemplo: Elemento/@atributo="1" se resolvería en true o false en función del valor de Elemento/@atributo).

 

Nota: para que este control funcione el dispositivo del cliente debe contar con permiso GPS.

 

Clic para expandir/contraerMostrar los controles del zoom

Indica si se deben mostrar en el mapa los controles del zoom. Los valores de esta propiedad pueden ser true o false; el valor predeterminado es true. Puede usar expresiones XPath para definir el valor de la propiedad de forma dinámica. Tenga en cuenta que los controles del zoom no se muestran en los dispositivos iOS.

 

Clic para expandir/contraerMarcadores

Establece el número de marcadores colocados en el mapa y sus correspondientes propiedades. La expresión XPath debe resolverse en una o más construcciones XPath de asignación: map-1, map-2, ... map-N. Cada construcción XPath consiste en un conjunto de pares clave-valor que, juntos, definen las propiedades de un marcador. Las claves que se usan son:

 

id: el valor es un ID para el marcador
geolocation: es una secuencia de dos cadenas o de dos números (enteros o decimales): la latitud y la longitud; por ejemplo: (48.2143531, 16.3707266)
title: una cadena que es el título de la ventana emergente que aparece al hacer clic en el marcador (en el mapa)
text: una cadena que es el texto de la ventana emergente que aparece al hacer clic en el marcador (en el mapa)

 

Una construcción XPath de asignación completa tendría este aspecto:

 

map {

    "id":"vie",

    "geolocation":(48.2143531, 16.3707266),

    "title":"Vienna",

    "text":"Altova EU"

}

 

La construcción XPath de asignación anterior crearía un marcador para la oficina de Altova EU en Viena. Para agregar más marcadores al mapa introduzca más construcciones XPath de asignación separadas por coma: map-1, map-2, ... map-N.

 

mt-geo-map-marker()

La función de extensión XPath de MobileTogether mt-geo-map-marker se puede usar para generar marcadores dinámicamente. Cada función mt-geo-map-marker devuelve una construcción XPath-map, es decir, un marcador. Para crear varios marcadores debe usar varias funciones mt-geo-map-marker. Para más información sobre esta función consulte la descripción de mt-geo-map-marker().

 

Clic para expandir/contraerÁrea de visualización

Una expresión XPath que evalúa en dos coordenadas de geoubicación: la esquina superior izquierda y la inferior derecha del rectángulo que corresponde al área de visualización. Este área es la superficie que aparece en el mapa de geoubicación. Tenga en cuenta que las dimensiones del control Mapa de geoubicación se definen con las propiedades Ancho del control y Alto del control. Si está definida correctamente, el área de visualización se encuentra dentro del área del mapa que aparece en el control.

 

La expresión XPath debe evaluar en una secuencia de dos cadenas donde cada cadena es un conjunto de coordenadas. En el ejemplo siguiente la primera cadena corresponde a la coordenada de la parte superior izquierda y la segunda cadena a la coordenada de la parte inferior derecha: ("61° -10°", "41° 10°"). La coordenada de la parte superior izquierda sería 61ºN 10ºW, mientras que la de la parte inferior derecha sería 41ºN 10ºE. Estas coordenadas crearían un área de visualización de unos 10º cuadrados en Londres (aprox. 51ºN 0ºE).

 

La configuración predeterminada para el área de visualización son las coordenadas de un rectángulo que muestra todos los marcadores definidos con el mayor nivel posible de zoom.

 

geolocations-bounding-rectangle()

La función de extensión de Altova geolocations-bounding-rectangle se puede usar para crear un rectángulo que englobe un conjunto de geoubicaciones. La función devuelve las esquinas superior izquierda e inferior derecha de un rectángulo que abarca las geoubicaciones indicadas con el mayor nivel posible de zoom, es decir, lo más cerca posible de esos emplazamientos. El valor de retorno de la función es una secuencia de dos cadenas para que la función se pueda usar en una función XPath para generar el valor de la propiedad del área de visualización.
 

Para más información sobre la función consulte la descripción de geolocations-bounding-rectangle().

 

Haga clic para expandir/contraerAcción de control

Haga clic en el botón Examinar para abrir el cuadro de diálogo "Acciones". Aquí puede configurar qué acciones se llevan a cabo cuando se desencadena un evento del control. Los eventos del control están predefinidos y el cuadro de diálogo ofrece una pestaña para cada uno de ellos. En el panel izquierdo del cuadro de diálogo está la biblioteca de acciones. Desde aquí puede arrastrar una acción hasta la pestaña del evento correspondiente. Después puede definir las propiedades de la acción elegida. Por cada evento puede configurar varias acciones, que se ejecutarán en el orden en el que aparecen, de arriba a abajo.

 

Una vez definidas, las acciones del control se pueden editar en cualquier momento (haciendo clic en el botón Examinar de la propiedad). También puede acceder a un evento del control haciendo clic con el botón derecho del ratón en el control y seleccionando el evento en el menú contextual que aparece.

 

Haga clic para expandir/contraerVisible

Una expresión XPath que debe dar como resultado true() o false(). Si da como resultado false(), entonces el control no estará visible. Si la expresión da como resultado true() o devuelve algún otro valor, entonces el control estará visible. El valor predeterminado es true(). Haga doble clic en el campo de valor o clic en el botón XPath para escribir o editar la expresión XPath. Esta propiedad se puede usar para presentar en pantalla un objeto visible dependiendo de si la expresión XPath da como resultado true(). Es decir, la presentación en pantalla del objeto se puede configurar de forma dinámica, según el contenido o la estructura de los datos.

 

Nota:  para más información sobre la visibilidad de columnas/filas distribuidas consulte la sección Propiedades de tabla.

 

Nota:  la variable $MTControlValue no se puede usar para evaluar la propiedad Visible. Si la utiliza se producirá un error de validación.

 

Haga clic para expandir/contraerAlineación horizontal

Establece la alineación horizontal a la izquierda, en el centro o a la derecha. El valor predeterminado es center. También puede configurar el valor con una expresión XPath (lo cual permite generar el valor de forma dinámica).

 

Haga clic para expandir/contraerAncho del control

Establece el ancho del control. Seleccione un valor del cuadro combinado:

 

rellenar_principal: ajusta el ancho del control al ancho del elemento principal (por ejemplo, la celda de tabla o la página donde se incluye el control).
ajuste_automático_línea: ajusta el ancho del control al contenido. Cuando se selecciona este valor, se habilita la propiedad Ancho máximo del control.
valor porcentual: un porcentaje del ancho de la página. Seleccione un valor de la lista o escriba un valor directamente.
valor en píxeles: seleccione un valor en píxeles de la lista desplegable o escriba un valor directamente.

 

En efecto, fill_parent genera el ancho máximo, mientras que wrap_content crea el ancho mínimo.

 

El valor predeterminado para todos los controles es fill_parent, excepto para estos:

 

Image y Chart: el valor predeterminado de estos controles es wrap_content.
Geolocation Map: el valor predeterminado es el menor de los valores de $MT_CanvasX y $MT_CanvasY. Estas dos variables dinámicas dan, respectivamente, el ancho y el alto del área de visualización del dispositivo. El valor predeterminado de ambos controles es el mismo (en ambos casos, el menor de los valores de $MT_CanvasX y $MT_CanvasY), por lo que el área de visualización del control siempre será un cuadrado cuyo lado es igual a min($MT_CanvasX, $MT_CanvasY).

 

Si introduce valores en píxeles para las propiedades que definen la longitud de un control, debe tener en cuenta que en dispositivos iOS estos valores se leerán como puntos del espacio de coordenadas del área de visualización. El espacio de coordenadas del área de visualización es el lienzo donde se dibujan los componentes de diseño y un punto es la unidad de longitud en este espacio (es decir, aquí los puntos no equivalen a la unidad tipográfica igual a 1/72 de una pulgada). El dispositivo iOS asigna automáticamente puntos del espacio de coordenadas del área de visualización a píxeles del espacio de coordenadas del dispositivo. Al asignar los valores de esta manera (de valores del área de visualización a valores del dispositivo) garantiza que los componentes de diseño conserven la misma relación de tamaño tanto con el lienzo como entre ellos, independientemente de la resolución del dispositivo iOS o de qué unidades se usen.

 

En MobileTogether Designer puede utilizar las variables dinámicas $MT_CanvasX y $MT_CanvasY para averiguar las dimensiones del área de visualización (lienzo de dibujo) actual y obtener así distancias relativas a esas dimensiones. Para dispositivos iOS las variables devuelven valores que se calculan de esta manera: las dimensiones en píxeles del espacio actual de coordenadas del dispositivo se convierten (usando un factor de conversión apropiado) en valores de puntos del espacio de coordenadas del área de visualización. Las variables devuelven estos valores de puntos en píxeles para utilizarlos en el diseño. Por ejemplo, si desea que una imagen sea la mitad del ancho del área de visualización, basta con asignarle un ancho en píxeles igual a $MT_CanvasX * 0.5; la expresión XPath para el ancho de esta imagen sería concat($MT_CanvasX * 0.5, 'px').

 

Haga clic para expandir/contraerAlto del control

Establece el alto del control. Seleccione un valor del cuadro combinado:

 

rellenar_principal: ajusta el alto del control al elemento principal (por ejemplo, la celda de tabla o la página donde se incluye el control).
ajuste_automático_línea: ajusta el ancho del control al contenido.

 

En realidad, el valor rellenar_principal crea un alto máximo, mientras que ajuste_automático_línea crea un alto mínimo. El alto predeterminado de todos los controles es ajuste_automático_línea.

 

Haga clic para expandir/contraerMargen

Indica el margen máximo del control en relación a los objetos que lo rodean o al borde del objeto que lo contiene. Seleccione un valor en píxeles de la lista desplegable del cuadro combinado o haga doble clic en el campo del valor para escribir un valor en píxeles. La configuración definida se aplicará a los cuatro lados del control. Para definir un margen distinto para alguno de los cuatro lados, expanda la propiedad Margen para mostrar las propiedades individuales de ancho (izquierda, derecha, superior e inferior) e indique el valor deseado. Por ejemplo, si indica que el Margen es de 6px y el Margen inferior es de 12px, entonces el margen será de 6px en los lados izquierdo, derecho e inferior, y de 12px en el lado inferior.

 

Si introduce valores en píxeles para las propiedades que definen la longitud de un control, debe tener en cuenta que en dispositivos iOS estos valores se leerán como puntos del espacio de coordenadas del área de visualización. El espacio de coordenadas del área de visualización es el lienzo donde se dibujan los componentes de diseño y un punto es la unidad de longitud en este espacio (es decir, aquí los puntos no equivalen a la unidad tipográfica igual a 1/72 de una pulgada). El dispositivo iOS asigna automáticamente puntos del espacio de coordenadas del área de visualización a píxeles del espacio de coordenadas del dispositivo. Al asignar los valores de esta manera (de valores del área de visualización a valores del dispositivo) garantiza que los componentes de diseño conserven la misma relación de tamaño tanto con el lienzo como entre ellos, independientemente de la resolución del dispositivo iOS o de qué unidades se usen.

 

En MobileTogether Designer puede utilizar las variables dinámicas $MT_CanvasX y $MT_CanvasY para averiguar las dimensiones del área de visualización (lienzo de dibujo) actual y obtener así distancias relativas a esas dimensiones. Para dispositivos iOS las variables devuelven valores que se calculan de esta manera: las dimensiones en píxeles del espacio actual de coordenadas del dispositivo se convierten (usando un factor de conversión apropiado) en valores de puntos del espacio de coordenadas del área de visualización. Las variables devuelven estos valores de puntos en píxeles para utilizarlos en el diseño. Por ejemplo, si desea que una imagen sea la mitad del ancho del área de visualización, basta con asignarle un ancho en píxeles igual a $MT_CanvasX * 0.5; la expresión XPath para el ancho de esta imagen sería concat($MT_CanvasX * 0.5, 'px').

 

Clic para expandir/contraerHoja de estilos

La propiedad Hoja de estilos establece qué hoja de estilos se debe usar para el control. La lista desplegable del cuadro combinado de esta propiedad incluye todas las hojas de estilos creadas por el usuario definidas en el proyecto. Seleccione la hoja de estilos que desea usar para el control. Si lo prefiere, también puede usar una expresión XPath para seleccionar la hoja de estilos. La ventaja de usar una XPath es que la selección de la hoja de estilos puede ser condicional (véase Aplicar hojas de estilos creadas por el usuario). Para más información consulte la sección Hojas de estilos.

 

Haga clic para expandir/contraerClase CSS del explorador

El nombre de la clase CSS que quiere asociar con este control. Si quiere asociar varias clases con el control, sepárelas por medio de espacios (p. ej. Clase1 Clase2). Después puede usar estas clases en un archivo CSS (el que se especifica en el cuadro de diálogo "Configuración del explorador") para asignar propiedades para este control concretamente. También puede usar una expresión XPath para generar los nombres de clase o recuperarlos.

 

 


© 2019 Altova GmbH