Infoburbujas
Dernière mise à jour
Dernière mise à jour
K2 Geospatial 2022
Las infoburbujas son burbujas de información que se despliegan sobre el mapa cuando el cursor pasa sobre un elemento. La información comprende texto, valores de atributos, hiperenlaces, imágenes, etc. El administrador determina la información que se muestra en las burbujas de cada capa.
El contenido de las infoburbujas puede ser formateado mediante marcas HTML y puede contener también programas JavaScript.
Para configurar las infoburbujas de una capa, presione Infoburbujas en la sección de detalles de la capa.
Infoburbuja | |
Infoburbuja | Ingrese el contenido de la infoburbuja. Consulte las secciones siguientes para obtener detalles sobre la sintaxis. |
Color de fondo | Seleccione el color de fondo de la infoburbuja. |
Prevenir la duplicación del texto | Seleccione esta opción para evitar que un mismo texto esté repetido varias veces en la misma burbuja, lo que puede producirse cuando muchos elementos de una misma capa poseen el mismo contenido de infoburbuja (ej.: segmentos de calle en una intersección). |
Escala mínima | Active esta opción e ingrese la escala mínima a partir de la cual se visualiza la infoburbuja. |
Escala máxima | Active esta opción e ingrese la escala máxima a partir de la cual se visualiza la infoburbuja. |
Debe proporcionar el texto que será utilizado como contenido de la infoburbuja.
El texto puede estar compuesto de partes estáticas (que se visualizarán tal cual son escritas), de partes variables (funciones que serán sustituidas por otro valor al ser visualizadas), de programas JavaScript simples y de marcas HTML. Por ejemplo, la función elementValue(city)
será reemplazada en la visualización, por el valor del atributo city del elemento al que se apunta.
La sintaxis de las infoburbujas está compuesta de distintas funciones que determinan su contenido. Las funciones y sus parámetros no son sensibles a la letra mayúscula o minúscula. Por ejemplo, ev(city)
equivale a Ev(CITY)
.
La tabla siguiente detalla las distintas funciones disponibles:
Función | Descripción |
elementValue(attrib) o ev(attrib) attrib: el nombre de un atributo | Sustituida por el valor, para el elemento apuntado, del atributo vinculado que se pasa en parámetro.
Por ejemplo, |
elementId() | Sustituida por el identificador del elemento. |
polygonArea() | Sustituida por la superficie del elemento poligonal al que se apunta. |
lineLength() | Sustituida por la longitud del elemento lineal al que se apunta. |
centroid() | Sustituida par la coordenada del centroide geométrico de la geometría del elemento. |
format(attrib, format) attrib: el nombre de un atributo de tipo fecha o numérico format: el formato de fecha deseado | Sustituida por una fecha o un número formateado según un formato preciso.
Ejemplo
donde date_insp es el nombre del atributo que contiene una fecha y dd/MM/yyyy es el formato de fecha deseado, tal como se indica en la documentación de la clase Java java.text.SimpleDateFormat
Ejemplo
donde attrib es el nombre de un atributo que contiene un número y ##0,00 es el formato deseado, tal como se indica en la documentación de la clase Java java.text.DecimalFormat. |
ifNull(attrib, value) attrib: el nombre del atributo que se probará value: el valor que se visualizará si attrib es nulo | Sustituida por el valor value solamente si el valor del atributo attrib es nulo.
Si el valor del atributo es no nulo, no se visualiza nada.
Ejemplo
Se visualiza el valor del atributo attrib_b si el valor de attrib_a es nulo. |
ifNotNull(attrib, value) attrib : el nombre del atributo que se probará value : el valor que se visualizará si attrib es no nulo | Sustituida por el valor value solamente si el valor del atributo attrib es no nulo. Si el valor del atributo es nulo, no se visualiza nada. Ejemplo
|
subString(attrib, startIx, endIx) attrib: el nombre del atributo del que se desea extraer una parte del valor startIx: posición de comienzo en la cadena de caracteres endIx: posición de fin en la cadena de caracteres | Sustituida por una parte del valor (como cadena de caracteres) del atributo attrib, entre la posición startIxy la posición endIx. Ejemplo
|
encode(attrib, encoding) attrib: el nombre del atributo a codificar encoding: el nombre de la codificación | Sustituida por el valor del atributo attrib codificado mediante la codificación de caracteres especificada (UTF-8, CP437, ISO 8859-1, etc.) Ejemplo
|
<script> code JavaScript</script> | Ejecuta el código JavaScript que está entre las marcas. En el código JavaScript, los valores de los atributos son accesibles mediante la función Muestra el valor del atributo osm_name y la distancia en millas con un valor decimal. |
<a href="download:*file URL">some text*</a> | JMap soporta una sintaxis especial de hiperenlace que permite que el usuario descargue un archivo haciendo clic en el enlace. El archivo que descarga puede provenir de un URL de tipo http: o file:.
Ejemplo
|
photosAsThumbnails() | Reemplazada por imágenes miniatura de las imágenes vinculadas al elemento. El usuario puede hacer clic sobre una miniatura para abrir la imagen en tamaño real.
|
projectName() | Sustituida por el nombre del proyecto en curso. |
userName() | Sustituida por el nombre del usuario actualmente conectado. |
sessionId() | Sustituida por el identificador de la sesión en curso. |
host() | Sustituida por el nombre del host o la dirección de la instancia del servidor JMap Server a la cual se conecta la aplicación. |
port() | Sustituida por el número del puerto (http o directo) de la instancia de JMap Server a la cual se conecta la aplicación. |
date() | Sustituida por la fecha y hora actual. |
Resulta posible formatear el contenido de la burbuja mediante marcas HTML simples. Las burbujas no soportan las marcas avanzadas tales como <DIV>
o CSS. Las marcas HTML soportadas y utilizadas en general en las infoburbujas son las siguientes:
<B>, <I>, <U>, <A>, <IMG>, <TABLE>, <BR>
Usted puede insertar hiperenlaces en las burbujas. Haciendo clic en ellos puede abrir páginas HTML o abrir y descargar archivos.
Contenido de la infoburbuja | Visualización |
| |
| |
| |
| |
Un ejemplo de marca El valor del atributo AREA_KM2 es convertido de km cuadrados a millas cuadradas. | |
Un ejemplo de formateo con atributo de estilo. |
Las infoburbujas incluyen una función para localizar coordenadas o elementos de un mapa utilizando una sintaxis especial de URL. En la infoburbuja se muestra un hiperenlace que al ser presionado sitúa al mapa en la región o en los elementos especificados. Esta función está disponible sólo en JMap Pro.
Ejemplo de localización con infoburbujas | Descripción |
| Muestra un hiperenlace Localizar. Cuando se presiona, este hiperenlace localiza en el mismo mapa la región definida por x= ‑ 73, y = 45, ancho = 5, altura = 5. Estos datos se expresan en las unidades del mapa. |
| Muestra un hiperenlace Localizar. Cuando se presiona, este hiperenlace localiza en el mismo mapa los elementos que en la capa métros tienen el valor del atributo nom igual a atwater. |
| Muestra un hiperenlace Localizar. Cuando se presiona, este hiperenlace localiza en el mismo mapa los elementos que en la capa métros tienen el valor del atributo nom que comienza con la letra a. |
| Muestra un hiperenlace Localizar. Cuando se presiona, este hiperenlace localiza en el mismo mapa los elementos que en la capa métros tienen el valor del atributo nom igual a atwater. El mapa resultante posee una escala de 1:1000. |
| Muestra un hiperenlace Localizar. Cuando se presiona, este hiperenlace localiza en un nuevo mapa llamado Resultado, los elementos que en la capa métros tienen el valor del atributo nom igual a atwater. Si ya existe un mapa llamado Resultado, se reutiliza. Si el nombre del mapa fuese new, se crearía un nuevo mapa, con un nombre generado automáticamente, cada vez que se presiona el hiperenlace. |
Puede especificar un URL que mostrará el contenido de una página HTML en la infoburbuja (esta función es soportada sólo en las aplicaciones JMap Pro). La burbuja estará completamente ocupada (100%) por la página HTML. La sintaxis es la siguiente:
$URL{http://awebsite.com}
El URL especificado puede ser estático o puede proceder de un atributo. Puede también utilizar los valores de un atributo como parámetros, como en el ejemplo siguiente:
$URL{http://awebsite.com?param1=ev(ATTRIB_A)¶m2=ev(ATTRIB_B)}
La figura ilustra un ejemplo de contenido HTML en una infoburbuja, referenciada mediante un URL.