CartoDroid Manual de Referencia v0 44 X

CartoDroid
Manual de referencia
Instituto Tecnolgico Agrario de

Castilla y Len
www.itacyl.es
v0.44.x / Marzo 2017
Antonio Carln Pareces, Jos Carlos Peas Lpez,
Javier Ramos Valle, Gustavo Ro Briones
www.cartodroid.es
Manual de referencia de CartoDroid
NDICE
1. Introduccin ........................................................................................................................... 3
2. Estructura de ficheros de la aplicacin. ............................................................................... 4
3. Creacin de capas desde CartoDroid................................................................................... 5
4. Gestin de proyectos con CRTDRD ..................................................................................... 8
5. Configuracin de capas en proyectos ................................................................................. 9
5.1 Estructura general del fichero ............................................................................................................. 9
5.2 Configuracin de capa Vectorial ....................................................................................................... 10
5.3 Configuracin de capa Raster ............................................................................................................ 13
5.4 Configuracin de orgenes de datos ................................................................................................ 14
5.4.1 Orgenes de datos para capas vectoriales .............................................................................. 14
5.4.2 Orgenes de datos para capas raster ...................................................................................... 16
6. Configuracin de simbologas en proyectos ..................................................................... 20
6.1 Estructura general del fichero ........................................................................................................... 20
6.2 Relacin entre estilos y simbologas ............................................................................................... 21
6.3 Estilos y simbologas para puntos .................................................................................................... 22
6.3.1 Definicin de estilos ................................................................................................................. 22
6.3.2 Definicin de simbologa .......................................................................................................... 22
6.4 Estilos y simbologas para lneas ...................................................................................................... 23
6.5 Estilos y simbologas para polgonos .............................................................................................. 24
6.6 Estilos y simbologas para etiquetas ............................................................................................... 25
6.7 Estilos y simbologas por defecto ..................................................................................................... 26
6.8 Simbologas condicionales .................................................................................................................. 27
7. Configuracin de la visualizacin de formularios ............................................................. 29
7.1 Estructura general del fichero ........................................................................................................... 29
7.2 Configuracin de campos del formulario ...................................................................................... 30
8. Casos prcticos de parametrizacin de capas vectoriales .............................................. 34
8.1 Configuracin de capa vectorial con mltiples ficheros .......................................................... 34
8.2 Configuracin de capa vectorial con restricciones para la edicin ..................................... 34
8.3 Definir una etiqueta dinmica ........................................................................................................... 35
8.4 Cambiar la vista de identificacin de una entidad. .................................................................... 35
8.5 Cambiar la vista de la lista de entidades. ....................................................................................... 36
1
8.6 Configurar filtros reutilizables para una capa ............................................................................. 36

8.7 Configurar nombres de las imgenes tomadas con CartoDroid ........................................... 37
8.8 Configuracin de lista desplegable para campo de la tabla ................................................... 37
8.9 Simbolizacin de entidades por expresin ................................................................................... 38
8.10 Cambiar los markers por defecto de las simbologas puntuales .......................................... 40
8.11 Mostrar puntas de flecha en las entidades lineales ................................................................... 40
9. Sobre las capas SQLite-Spatialite en CartoDroid .............................................................. 41
9.1 Requisitos .................................................................................................................................................. 41
9.2 Nomenclatura de los nombres de campos de las tablas .......................................................... 41
2
1. Introduccin
CartoDroid es una aplicacin desarrollada en el Instituto Tecnolgico Agrario de Castilla y Len
(ITACyL) pensada como herramienta de apoyo para el trabajo en campo, que busca resolver el
problema de la edicin de informacin georeferenciada sin conexin de datos en el dispositivo.
En muchas zonas de campo la cobertura de redes mviles es inexistente o insuficiente para
trabajar de forma eficaz, CartoDroid da solucin a este problema permitiendo visualizar capas
vectoriales y raster descargadas en el propio dispositivo y crear geometras dibujndolas
directamente en la pantalla o utilizando el GPS.
CartoDroid no requiere de conocimientos GIS previos para su manejo y es fcil de configurar y
utilizar, lo que abre la puerta a que cualquier persona pueda usarla para manejar informacin en
campo y despus exportar los datos grabados para utilizarlos en otras aplicaciones.
3
2. Estructura de ficheros de la aplicacin.

Tras la instalacin de CartoDroid en un dispositivo, la herramienta configura la siguiente estructura
de directorios:
CARTODROID
CONFIG DATA VALUES TEMP PICTURES
config: contiene los ficheros de configuracin de los proyectos, tanto el bsico que viene de
base con CartoDroid, como de los proyectos creados por usuarios. En el directorio se
encuentra:
o crtdrdLayers.<id_proyecto>.xml: ficheros de configuracin de proyectos. Por defecto
con la instalacin de CartoDroid se incluye un fichero crtdrdLayer.xml sin contenido
para trabajar en el proyecto bsico.
o crtdrdSymbologies.<id_proyecto>.xml: fichero de configuracin de simbologas
personalizadas para el proyecto.
o crtdrdStockSymbologies.xml: fichero de configuracin de las simbologas bsicas
incluidas de base en la instalacin.
o sigpac.properties: configuracin de las tablas que se utilizarn para la bsqueda de
recintos SIGPAC.
data: directorio por defecto para almacenar las las bases de datos sqlite que se crean desde
la herramienta.
values: en este directorio se encuentran los archivos para almacenar valores constantes
que utilizaremos en la aplicacin. (Ej: sistemas de explotacin).
temp: directorio con archivos temporales de la aplicacin.
pictures:
directorio donde se almacenarn las fotos tomadas desde CartoDroid (asociadas a
entidades geogrficas).
4
3. Creacin de capas desde CartoDroid

En esta seccin se indica cmo crear una capa vectorial desde cero con CartoDroid.
1. Para la creacin de capas desde CRTDRD, lo primero que debemos hacer es abrir la TOC.
2. Pulsando el botn Aadir capa. Se abrir el dialogo de creacin de capas.
5
3. Seleccionamos la opcin Crear una nueva capa vectorial y aparecer el siguiente

formulario:
a) En la parte superior se muestran campos bsicos de

identificacin y visualizacin de la capa:
La identificacin y el nombre sern los valores que
aparecern identificando a la capa en el men de la
tabla de contenidos.
Tipo: debemos seleccionar el tipo de geometra con
la que vamos a trabajar: punto (ej: puntos de
inters, rboles, cepas, ), lnea (tracks, lindes, )
o polgonos (trabajo con superficies)
Escala mnima y mxima indican los niveles de
zoom a los que la capa estar visible (niveles van
del 0 al 21, ste ltimo el ms cercano al suelo).
Escala mnima y mxima de etiquetas, tiene el
mismo significado que el anterior pero para las
etiquetas de las geometras.
b) Inmediatamente despus, aparece una seleccin de

campos especiales propuestos, que sern
automticamente aadidos a la capa si se deja
marcado el check.
Galera de fotos: abre la posibilidad de adjuntar
fotos a las entidades de una capa (puntos, lneas
y polgonos).
Referencia de recinto: aade un campo a la capa
para actualizarlo con la referencia del recinto que
se encuentra debajo de la entidad.
Inspeccionado: marca de trabajo para indicar que
esta entidad ha sido inspeccionada.
Fechas de creacin/actualizacin: dos campos
para indicar cundo se cre la entidad y cundo
se realiz el ltimo cambio sobre ella.
Fecha de inspeccin: campo de fecha.
Observaciones: campo de texto para rellenar en
campo.
6
c) En el siguiente apartado, dentro del mismo formulario, el

usuario puede aadir los campos que necesite. Para cada
campo se debe indicar el nombre y el tipo. CartoDroid
soporta tipos
Text: texto
Integer: nmero entero sin decimales
Double: nmero con decimales.
Date: fecha.
Boolean: campo booleano (si/no, 1/0).
d) Por ltimo, se debe seleccionar la simbologa de la capa. La

simbologa va a determinar la forma en que se pintar las
entidades de la capa (borde, color de fondo, transparencia,
etc.)
Por defecto CartoDroid trae una serie de simbologas
predefinidas para que el usuario elija, pero cada
proyecto puede definir sus propias simbologas.
La simbologa se puede definir tanto a nivel de entidad
(geometra), como de etiqueta, si se quiere que el texto
identificativo que aparece en el mapa aparezca con un
determinado estilo.
Tambin es posible configurar simbologas
condicionadas, en base a atributos de la entidad o de
reglas como veremos ms adelante.
Con los datos introducidos en el formulario la aplicacin crear una base de datos sqlite-spatialite
en el directorio /cartodroid/data del dispositivo y actualizar el fichero cartodroid/config/
crtdrdLayers.xml para incluir la definicin de la nueva capa.
7
4. Gestin de proyectos con CRTDRD

CartoDroid es una herramienta multiproyecto que permite tener varias configuraciones de trabajo
en una misma instalacin. Cada proyecto tiene sus propios ficheros de configuracin, todos ellos
almacenados en la carpeta /cartodroid/config.
Desde la propia herramienta se pueden crear y cargar proyectos con los botones que aparecen en
la parte inferior de la TOC.
La configuracin de un proyecto CartoDroid se apoya principalmente en dos ficheros almacenados

en la carpeta /cartodroid/config:
crtdrdLayers.<id_proyecto>.xml: contiene la configuracin de las capas del proyecto, es
obligatorio. Por defecto con la instalacin de CartoDroid se incluye un fichero
crtdrdLayer.xml sin contenido para trabajar en el proyecto bsico.
crtdrdSymbologies.<id_proyecto>.xml: fichero de configuracin de simbologas

personalizadas para el proyecto. Es optativo, si no se incluye, se utilizar el fichero
crtdrdSymbologies.xml que viene por defecto con la instalacin para buscar los estilos y
simbologas.
8
5. Configuracin de capas en proyectos

CartoDroid permite al usuario parametrizar un conjunto limitado de opciones sobre las capas y la
TOC. Para poder utilizar toda la potencia de la herramienta hay que recurrir a la configuracin
manual. En este apartado se describe el contenido y estructura de los ficheros de configuracin y
se incluyen ejemplos prcticos de manejo.
5.1 Estructura general del fichero

Por cada proyecto quetengamos configurado en CartoDroid, existir un fichero
crtdrdLayer.<id_proyecto>.xml en la carpeta cartodroid/config/. Este fichero almacena la
referencia a las capas que se visualizarn en el proyecto y el comportamiento de las mismas
(visualizacin, permisos, operaciones, etc).
Etiqueta Descripcin
WKSLayerConfiguration Elemento raz del fichero de configuracin. Tendr anidado un
elemento layers, dentro del cual se configuran las capas con
etiquetas entry.
layers Elemento que agrupa el listado de capas del proyecto.
entry Representa una entrada en la TOC. Debe tener anidados dos
elementos, string, que ser el identificador de la capa, y otro
elemento con la referencia al modelo de capa concreto a utilizar:
es.jcyl.ita.crtcyl.core.model.VectorialLayer: para aadir una
capa vectorial.
es.jcyl.ita.crtcyl.core.model.RasterLayer: para aadir una capa
raster.
Un ejemplo de este fichero:

<es.jcyl.ita.crtcyl.core.config.WKSLayerConfiguration>
<layers class="java.util.LinkedHashMap">

<entry>
<string>tareas</string>
<es.jcyl.ita.crtcyl.core.model.VectorialLayer>
...
</es.jcyl.ita.crtcyl.core.model.VectorialLayer>
</entry>

<entry>
<string>ortofotos_pnoa</string>
<es.jcyl.ita.crtcyl.core.model.RasterLayer>
...
</es.jcyl.ita.crtcyl.core.model.RasterLayer>
</entry>
...
</layers>
</es.jcyl.ita.crtcyl.core.config.WKSLayerConfiguration>
9
5.2 Configuracin de capa Vectorial

En la siguiente tabla se enumeran las etiquetas que se pueden utilizar dentro del elemento
es.jcyl.ita.crtcyl.core.model.VectorialLayer.
Etiqueta Descripcin
id
Identificador nico de la capa. Debe ser una cadena de texto sin espacios
en blanco, que contenga nicamente letras y dgitos.
nombre Nombre visible de la capa en la TOC.
descripcion Descripcin de la capa a mostrar en la TOC.
Tipos de features que almacena la capa: debe tener uno de estos valores:
10 para geometras MULTIPOINT
vectorialType
20 para geometras POLYLINE
30 para geometras MULTIPOLYGON
showOnTOC Determina si la capa se muestra en la lista de capas de la TOC.
Visualizacin y simbologas
orden Posicin en la capa en el listado de capas de la TOC.
zOrder
Determina el orden de solapamiento de las capas a la hora del pintado.
La capa con mayor zOrden aparece en el plano ms cercano al usuario.
Indica los niveles de zoom en los que la capa estar visible. Para indicarlo
se deben anidar dos etiquetas max y min para indicar el rango. Ej:
range <range>
<min>15</min>
<max>21</max>
</range>
labels Indica si las etiquetas deben renderizarse por defecto: true|false.
labelRange
Indica los rangos de visualizacin de las etiquetas. Se configura con
elementos anidados min/max de forma similar a la etiqueta range.
Expresin SQL a ejecutar para calcular la etiqueta ej:

labelExpression
<labelExpression>campo 1 || campo2</labelExpression>
showArrowHeads
Mostrar flechas de orientacin de los puntos de las entidades. Solo
aplicable para entidades lineales. true|false.
Identificador de simbologa a aplicar por defecto a las geometras de una

symbId capa. La simbologa debe existir en el fichero del proyecto o en el
crtdrdSymbologies.xml.
Identificador de simbologa a aplicar por defecto a las etiquetas de una

labelSymbId capa. La simbologa debe existir en el fichero del proyecto o en el
crtdrdSymbologies.xml.
symbologyExpression Expresin que se utilizar para calcular la simbologa de las entidades de
10
la capa.
labelSymbologyExpress Expresin que se utilizar para calcular la simbologa de las etiquetas de

ion las entidades.
Permisos y operaciones a nivel de capa
allowOverlaps Si se pueden crear geometras con solapes dentro de la misma capa.

true | false.
canChangeSymbology Si se permite modificar la simbologa de la capa. true|false.
canCopy Si se pueden copiar los elementos de una capa en otras. true|false.
canCreate Si se permite crear nuevos elementos en la capa. true|false.
canDeleteAll
Si se debe mostrar el botn Eliminar todos los elementos de la capa en
la TOC. true|false.
canDieCut Determina si se pueden troquelar las entidades de la capa. true|false.
canEditVertices
Si se debe mostrar la operacin Editar vrtices durante la edicin de una
geometra de la capa. true|false.
canExplode Si se permite utilizar la operacin de Explotar geometras en la capa.

true|false.
canPaste Si se permiten pegar geometras en la capa. true|false.
canSanitize Si debe aparecer el botn Limpiar los datos de la capa en la TOC.

true|false.
canZoomVisibles Si se debe mostrar el botn Hacer zoom a elementos visibles en la TOC.

true|false.
deletable Si se permite eliminar una entidad de la capa. true|false.
editable
Si se pueden editar las entidades de una capa (tanto la geometras como
los atributos). true|false.
identificable Si se operacin de identificacin debe estar activa para la capa. true |

false.
inspeccionable
Si el botn de Filtrado de inspecciones debe estar activo cuando la capa
est seleccionado. true|false.
Determina si se puede configurar la capa (nombre, descripcin,

layerEditable
restricciones de escala). true|false.
layerRemovable Si se puede eliminar la tabla de la TOC. true|false.
searchable
Si al mostrar el listado de entidades de la capa, se muestran los filtros de
bsqueda. true|false.
selectable Si las entidades de la capa pueden seleccionarse. true|false.
11
visible Si la capa es visible o no en la TOC. true|false.
Origen de informacin de la capa
Define el origen de datos para localizar la base de datos o fichero en el

que se encuentra la capa. Una capa puede incluir varios orgenes de
datos. Dentro de esta etiqueta se incluir uno de los siguientes
sources
elementos. Ver ms adelante su configuracin especfica:
es.jcyl.ita.crtcyl.client.dao.source.SpatiaLiteServiceDescriptor
es.jcyl.ita.crtcyl.client.dao.source.RepoSpatiaLiteServiceDescriptor
Configuracin de formularios
alphaEditFinisher
Identificador del formulario que a utilizar para editar los atributos de la
capa.
attributesClassName
Clase que se utilizar para recuperar la informacin de la capa. Ver
apartado de orgenes de datos para ms informacin.
editAfterCreation
Si despus de una edicin o creacin se debe lanzar el formulario de
edicin de atributos. true|false.
Relaciona los campos del formulario que mostrarn un desplegable de

seleccin con el fichero en el que estn los valores. Si hay ms de uno,
se separan con el carcter ;.
C_USO_SIGPAC=alegaciones15usoSIGPAC;b_B_SUP_COMPROBADA=siNO;
Para el campo C_USO_SIGPAC de la capa se mostrarn los valores

valuesFromList contenidos den el fichero /cartodroid/values/
alegaciones15usoSIGPAC.properties.
Que tendr el formato <cdigo>=<valor>:

TA=TIERRAS ARABLES (TA)
PR=PASTO ARBUSTIVO (PR)
PA=PASTO CON ARBOLADO (PA)
sqlIdentify Consulta que se va a ejecutar para la identificacin.
sqlAsListView Consulta que se ejecutar para mostrar la lista de entidades
Consulta sql que se ejecutar para filtrar las entidades. El texto

definitionQuery introducido dentro de la etiqueta se aplica como una clusula where dentro
de la consulta de recuperacin de datos (filtro).
En el siguiente ejemplo se muestra el mnimo XML que se debe definir para configurar una capa
vectorial. En este caso es una capa poligonal (vectorialType=30), el fichero de BD se llama
plantaciones.sql y se encontrar en la carpeta cartodroid/data. La tabla que almacena la capa se
llama tambin plantaciones y tienen un ndice geogrfico idx_plantaciones_Geometry.
<layers class="java.util.LinkedHashMap">
<entry>
<string>capa1</string>
<id>plantaciones</id>
<name>Plantaciones</name>
<vectorialType>30</vectorialType> 
12
<srs>25830</srs>
<attributesClassName>es.jcyl.ita.crtdrd.data.DefaultSqlite</attributesClassName>
<sources>
<es.jcyl.ita.crtcyl.client.dao.source.SpatiaLiteServiceDescriptor>
<dbURL>plantaciones.sqlite</dbURL>
<dataTable>plantaciones</dataTable>
<indexTable>idx_plantaciones_Geometry</indexTable>
</es.jcyl.ita.crtcyl.client.dao.source.SpatiaLiteServiceDescriptor>
</sources>
<symbId>REBECA</symbId>
<range>
<max>21</max>
<min>0</min>
</range>
</entry>
</layers>
5.3 Configuracin de capa Raster
Etiqueta Descripcin
id
Identificador nico de la capa. Debe ser una cadena de texto sin espacios
en blanco, que contenga nicamente letras y dgitos.
nombre Nombre visible de la capa en la TOC.
descripcion Descripcin de la capa a mostrar en la TOC.

showOnTOC Determina si la capa se muestra en la lista de capas de la TOC.
Visualizacin y simbologas
orden Posicin en la capa en el listado de capas de la TOC.
zOrder
Determina el orden de solapamiento de las capas a la hora del pintado.
La capa con mayor zOrden aparece en el plano ms cercano al usuario.
Indica los niveles de zoom en los que la capa estar visible. Para indicarlo
se deben anidar dos etiquetas max y min para indicar el rango. Ej:
range <rango>
<max>21</max>
<min>15</min>
</rango>
Permisos y operaciones a nivel de capa
layerRemovable Si se puede eliminar la tabla de la TOC. true|false.
visible Si la imagen raster es visible o no.
Origen de informacin de la capa
sources Define el origen de datos para localizar la base de datos o fichero en el

que se encuentra la capa. Una capa puede incluir varios orgenes de
13
datos. Dentro de esta etiqueta se incluir uno de los siguientes

elementos. Ver ms adelante su configuracin especfica:
es.jcyl.ita.crtcyl.client.dao.source.RasterLiteServiceDescriptor
es.jcyl.ita.crtcyl.client.dao.source.RepoRasterLiteServiceDescriptor
es.jcyl.ita.crtcyl.client.dao.source.MBTilesServiceDescriptor
es.jcyl.ita.crtcyl.client.dao.source.RepoMBTilesServiceDescriptor
es.jcyl.ita.crtcyl.client.dao.source.WMSServiceDescriptor
5.4 Configuracin de orgenes de datos

Para definir la fuente de datos que debe utilizar CartoDroid para leer la informacin de una capa
se debe anidar una etiqueta <sources> dentro de la etiqueta de definicin de la capa, ya sea
VectorialLayer o RasterLayer.
Dentro de la etiqueta sources, vamos a poder definir los parmetros necesarios para localizar la
fuente de datos que contiene la cartografa, un descriptor. En el siguiente apartado veremos los
diferentes tipos de descriptores.
Por otro lado, en la configuracin de la capa, en el atributo attributesClassName, se le indica a
CartoDroid cmo debe procesar este descriptor y cmo debe tratar las geometras de la capa
cuando las lea.
5.4.1 Orgenes de datos para capas vectoriales

Para establecer un origen de datos contra una capa vectorial, debemos definir dos cosas:
La implementacin que se utilizar (etiqueta attributesClassName): determina cmo se van
a leer las geometras.
Descriptor del origen de datos: determina cmo se localizan los ficheros de BD de
referencia.
Seleccionar la implementacin de consulta de geometras
A la hora de definir el objeto que consultar las geometras hay que decidir dos parmetros:
a) Tratamiento de las geometras:
Geometras regulares: CartoDroid va a recuperar todas las geometras que intersecten con
la pantalla actual (extend o bbox). Cada geometra se recupera completa.
Geometras grandes: si el fichero spatialite tiene geometras extremadamente grandes (>
10.000 vrtices, estamos hablando de geometras con una amplitud muy superior al nivel
municipal, etc), con la aproximacin anterior, la navegacin se puede ver penalizada. En
estos casos se puede utilizar una implementacin que recupere solo la parte de las
geometras que se muestra en pantalla y no la geometra completa.
b) Definicin de la ruta al fichero de BD:
nico: en este caso solo queremos utilizar una nica base de datos
Mltiple: si queremos que las entidades que se muestran en una capa provengan de varios
ficheros de base de datos, CartoDroid puede consultar todas las BBDD cuyo nombre de
fichero empiece por una determinada cadena.
Utilizando esto, por ejemplo, podemos tener una capa de recintos sigpac, que utilice los
ficheros de Valladolid y Zamora poniendo en el descriptor:
<dbURL>recintos.sqlite</dbURL>
Y dejando en la misma carpeta los ficheros recintos_va.sqlite y recintos_za.sqlite.
14
De esta forma CartoDroid busca en esa misma carpeta todos los ficheros que empiecen
por recintos y tengan extensin sqlite y los utiliza como fuentes de datos para la capa
Nota: es importante resaltar, que los implentadores multi solo se pueden utilizar para
operaciones de consulta sobre entidades. Si se utiliza este tipo de implementador y se
intenta modificar una geometra o sus atributos, se mostrar un mensaje de error.
Combinando estos dos parmetros, tenemos los cuatro posibles valores que podemos aplicar en
la etiqueta <attributesClassName>.
Geometras sencillas Geometras complejas
Fichero
es.jcyl.ita.crtdrd.data.DefaultSqlite es.jcyl.ita.crtdrd.data.LargeSqlite
nico
Mltiples
es.jcyl.ita.crtdrd.data.MultiSqlite es.jcyl.ita.crtdrd.data.MultiLargeSqlite
ficheros
Descriptor de origen de datos

A la hora de definir la localizacin de una capa vectorial, CartoDroid admite dos tipos de
descriptor:
Descriptor de fichero: en este caso identificamos la localizacin exacta del fichero, con
una ruta absoluta en el dispositivo o relativa a la carpeta /CartoDroid/data.
Etiqueta Descripcin
es.jcyl.ita.crtcyl.client.dao.source.SpatiaLiteServiceDescriptor
Localizacin del fichero, con una ruta absoluta en el dispositivo o relativa

dbURL
a la carpeta /CartoDroid/data.
dataTable Nombre visible de la capa en la TOC.
indexTable Identifica el ndice geogrfico asociada a la capa
Ejemplo:
<dbURL>/storage/emulated/0/CartoDroid/data/plantaciones.sqlite</dbURL>
Descriptor por referencia a repositorio: el sistema anterior obliga a identificar el nombre

del fichero y complica la reutilizacin de cartografa entre diferentes proyectos y
extensiones. Existe una alternativa en la que se le indica a CartoDroid las caractersticas
de la capa, y ste se encarga de buscar en todo el sistema de ficheros del dispositivo una
capa con un nombre que cumpla esos requisitos.
15
Etiqueta Descripcin
es.jcyl.ita.crtcyl.client.dao.source.RepoSpatiaLiteServiceDescriptor
resourceid Localizacin del fichero, con una ruta absoluta en el dispositivo o relativa
a la carpeta /CartoDroid/data.
srid Sistema de referencia a utilizar en la capa.
version Identificador de la versin del producto cartogrfico.
dataTable Nombre visible de la capa en la TOC.
indexTable Identifica el ndice geogrfico asociada a la capa
Con estos atributos, CartoDroid buscar en todo el dispositivo un fichero con el nombre:
<resourceid>_<srid>_<version>.sqlite
Por ejemplo para esta definicin de capa:

<es.jcyl.ita.crtcyl.client.dao.source.RepoSpatiaLiteServiceDescriptor>
<resourceid>recintos</resourceid>
<srid>25830</srid>
<version>2016</version>
<dataTable>RECINTOS</dataTable>
<indexTable>idx_RECINTOS_Geometry</indexTable>
</es.jcyl.ita.crtcyl.client.dao.source.RepoSpatiaLiteServiceDescriptor>
CartoDroid intentar localizar un fichero de bd con el siguiente nombre:

recintos_25830_2016.sqlite
Si estamos utilizando un implementador multi (atributo attributesClassName), adems cartodroid

encontrar todas las BDs que empiecen por recintos_25830_2016 y tengan extensin .sqlite.
5.4.2 Orgenes de datos para capas raster

En el caso de las capas raster solo es necesario indicar un descriptor de origen de datos. Cada
formato o servicio raster soportado por CartoDroid tendr su propio descriptor.
Configuracin de capas rasterlite y MBTiles

De forma similar a las capas vectoriales, tendremos descriptores distintos en funcin de si
queremos referenciar la BD directamente por el nombre del fichero o por la referencia a sus
caractersticas cartogrficas:
Descriptor de fichero Descriptor de referencia a repositorio
es.jcyl.ita.crtcyl.client.dao.source. es.jcyl.ita.crtcyl.client.dao.source.
Rasterlite RasterLiteServiceDescriptor RepoRasterLiteServiceDescriptor
es.jcyl.ita.crtcyl.client.dao.source. es.jcyl.ita.crtcyl.client.dao.source.
MBTiles MBTilesServiceDescriptor RepoMBTilesServiceDescriptor
16
Configuracin de capa rasterlite con descriptor por referencia

<entry>
<string>ORTOFOTO</string>
<descripcion>Ortofotos PNOA 2014</descripcion>
<id>ORTOFOTO</id>
<name>Ortofotos</name>
<sources>
<es.jcyl.ita.crtcyl.client.dao.source.RepoRasterLiteServiceDescriptor>
<resourceid>ortos</resourceid>
<rastersTable>ortofotos</rastersTable>
<srid>4326</srid>
</es.jcyl.ita.crtcyl.client.dao.source.RepoRasterLiteServiceDescriptor>
</sources>
<zOrder>15</zOrder>
<range>
<max>21</max>
<min>16</min>
</range>
</entry>
Configuracin de capa MBTiles con descriptor por referencia

<entry>
<string>MAPASIGN</string>
<descripcion>Mapas Topogrficos del IGN 1/1.250.000, 1/500.000,1/200.000 y
1/25.000</descripcion>
<id>MAPASIGN</id>
<name>Mapas IGN</name>
<sources>
<es.jcyl.ita.crtcyl.client.dao.source.RepoMBTilesServiceDescriptor>
<resourceid>ignmapas</resourceid>
<srid>4326</srid>
</es.jcyl.ita.crtcyl.client.dao.source.RepoMBTilesServiceDescriptor>
</sources>
<zOrder>10</zOrder>
<range>
<max>15</max>
<min>6</min>
</range>
</entry>
17
Configuracin de servicio TMS (Tile Map Service)

CartoDroid puede consumir servicios TMS online, pero tambin puede servir teselas desde el
sistema de ficheros del dispositivo, siempre que estn almacenadas con una estructura similar a la
que mantienen los servidores TMS (base_cache/nivel_zoom/x/y).
En ambos casos el descriptor a utilizar es el mismo, es.jcyl.ita.crtcyl.client.dao.
source.WMSServiceDescriptor, pero en el caso de hacer referencia a un servicio online, la etiqueta
baseURI ser una URL que empiece por http, y en el caso de hacer referencia a una cach en el
dispositivo, indicaremos la ruta a la base de la cach.
La etiqueta intertY, determina el orden en el que debe crecer el eje de coordenadas y a la hora de
construir la url de la tesela. En la definicin del estndar TMS, la ruta a una tesela se construye
como:
${baseURI}/nivel_zoom/x/y.${imageExtension}
La coordenada y empieza a numerarse en la parte inferior del mapa. En cambio en el caso de

servicios de Google Maps, el eje y se empieza a numerar en la parte superior.
CartoDroid cubre los dos casos simplemente modificando el valor de la etiqueta invertY:
invertY = true: acceso a mapa de tiles tipo Google
invertY = false: acceso a mapa TMS estndar.
Para ms informacin sobre estas diferencias: http://www.maptiler.org/google-maps-coordinates-
tile-bounds-projection/
Configuracin acceso TMS online
<es.jcyl.ita.crtcyl.client.dao.source.TMSServiceDescriptor>
<baseURI>http://a.tile.openstreetmap.org</baseURI>
<imageExtension>png</imageExtension>
<invertY>false</invertY>
</es.jcyl.ita.crtcyl.client.dao.source.TMSServiceDescriptor>
Configuracin acceso cach TMS

<es.jcyl.ita.crtcyl.client.dao.source.TMSServiceDescriptor>
<baseURI>/sdcard/cartorepo/osm_cache/</baseURI>
<imageExtension>png</imageExtension>
<invertY>false</invertY>
</es.jcyl.ita.crtcyl.client.dao.source.TMSServiceDescriptor>
Configuracin de servicio WMS (Web Map Service)
CartoDroid soporta una implementacin mnima del acceso a servicios WMS. La versin actual no
soporta consultas de tipo GetCapabilities para comprobar capacidades del servidor, pero se
pueden configurar prcticamente todos los parmetros de una peticin WMS.
Etiqueta Descripcin
es.jcyl.ita.crtcyl.client.dao.source.WMSServiceDescriptor
Parmetro LAYERS de la peticin WMS indicando la capa o capas a

layerName consultar. Si se consulta ms de una capa simultneamente, separar con
comas los nombres.
format Parmetro FORMAT, por ejemplo image/png.
18
request Tipo de peticin WMS que se enviar al servicio, generalmente ser GetMap.
EPSG Sistema de referencia a utilizar.
transparent Transparencia de la tesela devuelta. True | false
quality Parmetro QUALITY para la peticin WMS.
wmsVersion Versin de wms a utilizar.
endpointList Configuracin de la ruta al servicio online.
Un ejemplo de configuracin de una capa que consulta un servicio WMS:

<entry>
<string>pnoa_wms</string>
<descripcion>PNOA WMS ITACyL</descripcion>
<id>pnoa_wms</id>
<name>pnoa_wms</name>
<sources>
<es.jcyl.ita.crtcyl.client.dao.source.WMSServiceDescriptor>
<layerName>Ortofoto_CyL</layerName>
<format>image/png</format>
<request>GetMap</request>
<EPSG>4326</EPSG>
<quality>50</quality>
<transparent>true</transparent>
<wmsVersion>1.0.0</wmsVersion>
<endPointList>
<es.jcyl.ita.crtcyl.core.model.source.EndPoint>
<URL>http://orto.wms.itacyl.es/WMS</URL>
</es.jcyl.ita.crtcyl.core.model.source.EndPoint>
</endPointList>
</es.jcyl.ita.crtcyl.client.dao.source.WMSServiceDescriptor>
</sources>
<zOrder>14</zOrder>
<range>
<max>21</max>
<min>0</min>
</range>
</entry>
19
6. Configuracin de simbologas en proyectos

La parametrizacin de cmo se visualizan las geometras y las etiquetas de las entidades de
capas vectoriales se establece en el fichero cartodroid/config/crtdrdSymbologies.xml.

A la hora de definir una simbologa, independientemente del tipo de geometra, se configura por
separado el estilo de la simbologa en s:
Estilo: determina colores, trazo y transparencias de figuras geomtricas.
Simbologa: permite establecer el estilo a aplicar para la visualizacin de la geometra y
para el de las etiquetas.
Etiqueta Descripcin
symbologyConf Elemento raz del fichero de configuracin. Tendr anidado un elemento estilos
y un elemento simbologias.
estilos Elemento que agrupa los elementos entry para definir los estilos.
simbologias Elemento que agrupa los elementos entry para definir las simbologas.
entry Dentro de los elementos estilos y simbologas, se pueden anidar uno ms
elementos entry.
En el caso de estilos, una entrada se define creando una etiqueta estilo, y en
el caso de simbologias, con la etiqueta symb. Adems cada elemento entry debe
llevar asociada una etiqueta string con un valor nico que identifica al
estilo/simbologa.
De forma general el fichero crtdrdSymbologies.xml tendr la siguiente estructura:

<symbologyConf>
<estilos>
<entry>
<string>estilo1</string>
<estilo class="estiloPoligono">
</estilo>
</entry>
<entry>
<string>estilo2</string>
</estilo>
</entry>
</estilos>
<simbologias>
<entry>
<string>simbologia1</string>
<symb class="poligono">

20
</symb>
</entry>
</simbologias>
</symbologyConf>
En los siguientes apartados se describe cmo crear una visualizacin a medida para cada tipo de
Geometra (punto, lnea, polgono).
6.2 Relacin entre estilos y simbologas

Existen cuatro tipo de estilos: texto, marker, lnea y polgono.
Estilo texto (estiloTexto): define color y tamao de la fuente.
Estilo marker (estiloMarca): define color y opcionalmente imagen de fondo a utilizar como
marca de posicin.
Estilo lnea (estiloLinea): color, ancho de trazo de la lnea, terminador, etc.
Estilo polgono (estiloPoligono): adems de la informacin asociada al estilo de lnea, color
de fondo.
Estos cuatro estilos se combinan para definir las simbologas de las entidades vectoriales. En el
caso de CartoDroid, se puede definir simbologas diferentes para las geometras y para las
etiquetas.
Cada tipo de capa vectorial tiene asociado un tipo de simbologa que se corresponde directamente
con el tipo de estilo. As, la simbologa polgono, tendr asociado un estilo de tipo estiloPoligono,
la simbologa de lnea un estiloLinea y la simbologa de punto un estiloMarca. Estas simbologas
se referencian en la capa con la etiqueta <symbId> (o utilizando una expresin definida en la
etiqueta <symbologyExpression>)
Para el caso de las etiquetas, la simbologa debe ser de tipo polgono, y tendr asociado un
estiloTexto para establecer el formato del texto, y un estiloPoligono, para dar formato al cuadro
que rodea al texto en s.
En el siguiente esquema se muestra la relacin entre las simbologas y los estilos.
Relacin entre estilos y simbologas
21
6.3 Estilos y simbologas para puntos

6.3.1 Definicin de estilos
Etiqueta Descripcin
Identificador del estilo. Debe coincidir con el atributo string definido en la

id
etiqueta entry.
transparencia Grado de transparencia a aplicar.
Color de la geometra. Debe llevar anidado un elemento rgb

color
<color><rgb>0,255,255,255</rgb></color>
Nombre del fichero de la imagen que se mostrar para sustituir el marker por
urlImagen
defecto de google. La imagen debe estar en el directorio /cartodroid/symbol.
rotation Rotacin a aplicar sobre la imagen (grados 0-360). Opcional.
6.3.2 Definicin de simbologa

Etiqueta Descripcin
Identificador de la simbologia. Debe coincidir con el atributo string definido en

id
la etiqueta entry.
idEstiloPunto Identificador de estilo que se utilizar para el marker.
<estilos> <simbologias>
<entry> <entry>
<string>symbSelectedPoint</string> <string>symbSelectedPoint</string>
<estilo class="estiloMarca"> <symb class="punto">
<id>symbSelectedPoint</id> <id>symbSelectedPoint</id>
<transparencia>1.0</transparencia> <idEstiloPunto>symbSelectedPoint
<color> </idEstiloPunto>
<rgb>0,255,255,255</rgb> </symb>
</color> </entry>
</estilo> </simbologias>
</entry>
</estilos>
Definicin de estilo de Marca Definicin de simbologa de punto
22
6.4 Estilos y simbologas para lneas

Etiqueta Descripcin

id
etiqueta entry.
Color de la geometra. Debe llevar anidado un elemento rgb

colorLinea
Configuracin del estilo del trazo de la lnea. En la actualidad se permite

modificar nicamente el ancho de la lnea, pero se prev aadir otras
posibilidades de visualizacin soportadas por el api de google-maps.
trazo https://developers.google.com/maps/documentation/android-api/releases
<trazo class=basicStroke>
<anchura>3</anchura>
</trazo>

Etiqueta Descripcin
Identificador de la simbologa. Debe coincidir con el atributo string

id
definido en la etiqueta entry.
idEstiloLinea Identificador de estilo que se utilizar para la lnea.
<entry> <entry>
<string>symbInspeccionLinea</string> <string>symbInspeccionLinea</string>
<estilo class="estiloLinea"> <symb class="linea">
<id>symbInspeccionLinea</id> <id>symbInspeccionLinea</id>
<transparencia>1.0</transparencia> <idEstiloLinea>symbInspeccionLinea</
<colorLinea> idEstiloLinea>
<rgb>0,255,255,255</rgb> </symb>
</colorLinea> </entry>
<trazo class=basicStroke> </simbologias>
</trazo>
</estilo>
</entry>
</estilos>
Definicin de estilo de lnea Definicin de simbologa de lnea
23
6.5 Estilos y simbologas para polgonos

Etiqueta Descripcin

id
etiqueta entry.
Color de la geometra. Debe llevar anidado un elemento rgb:

colorLinea
Color de fondo de la geometra. Debe llevar anidado un elemento rgb:

colorRelleno
<colorRelleno><rgb>255,145,0,80</rgb></colorRelleno>
Configuracin del estilo del trazo de la lnea. En la actualidad se permite

modificar nicamente el ancho de la lnea, pero se prev aadir otras
posibilidades de visualizacin soportadas por el api de google-maps.
trazo https://developers.google.com/maps/documentation/android-api/releases
<trazo class=basicStroke>
</trazo>

Etiqueta Descripcin
Identificador de la simbologia. Debe coincidir con el atributo string

id
definido en la etiqueta entry.
Identificador de estilo que se utilizar para la etiqueta de la geometra.

texto
Opcional (solo se utiliza cuando la simbologa se aplica a las etiquetas.
idEstiloPoligono Identificador de estilo que se utilizar para la lnea.
24
<entry> <entry>
<string>pend50</string> <string>pend50</string>
<estilo class="estiloPoligono"> <symb class="poligono">
<id>pend50</id> <id>pend50</id>
<transparencia>1.0</transparencia>
<colorLinea> <idEstiloPoligono>pend50</idEstiloPoligono>
<rgb>0,255,255,255</rgb> </symb>
</colorLinea> </entry>
<trazo class=basicStroke> </simbologias>
</trazo>
<colorRelleno>
<rgb>255,145,0,80</rgb>
</colorRelleno>
</estilo>
</entry>
</estilos>
Definicin de estilo de polgono Definicin de simbologa de polgono
6.6 Estilos y simbologas para etiquetas

Etiqueta Descripcin

id
etiqueta entry.
Etiqueta que permite definir atributos tipogrficos de la etiqueta. Ahora

fuente mismo solo est soportado el tamao. Ej:
<fuente><tamano>36</tamano></fuente>
Color de la letra a utilizar. Debe llevar anidado un elemento rgb:

colorTexto
<colorTexto><rgb>255,145,0,80</rgb></colorTexto>
25
<entry> <entry>
<string>idTextRojo</string> <string>label_rojas_symb</string>
<estilo class="estiloTexto"> <symb class="poligono">
<id>idTextRojo</id> <id>Default_label</id>
<transparencia>1.0</transparencia> <texto>idTextRojo</texto>
<fuente> <idEstiloPoligono>label_rojas_pol
<tamano>36</tamano> </idEstiloPoligono>
</fuente> </symb>
<colorTexto> </entry>
<rgb>255,0,0,255</rgb>
</colorTexto>
<rotacion>0.0</rotacion>
</estilo>
</entry>
Definicin de estilo de texto Definicin de simbologa de etiqueta
En este caso definimos una simbologa de tipo polgono label_rojas_symb que referencia a un
estilo de tipo texto idTextoRojo y a un estilo de tipo polgono label_rojas_pol. Para utilizar esta
simbologa, tendremos que referenciarla en la definicin de la capa del siguiente modo:
<labelSymbId>label_rojas_symb</labelSymbId>.
6.7 Estilos y simbologas por defecto

Con la instalacin de CartoDroid se incluye un fichero con simbologas y estilos por defecto
configurados en el fichero /cartodroid/config/crtdrdSymbologies.xml. Esta configuracin puede ser
sobrescrita por el proyecto sin ms que definir en el fichero de simbologas del proyecto un
estilo/simbologa con el mismo identificador.
Por ejemplo, la siguiente simbologa es utilizada por CartoDroid para definir la presentacin del
polgono del sketch de un corte vlido. Pegando este trozo de cdigo en el fichero de simbologas
del proyecto y modificndolo se modificara la visualizacin que por defecto da CartoDroid a este
tipo de sketch.
<entry>
<string>symbSketchLineOK</string>
<id>symbSketchLineOK</id>
<colorLinea>
<rgb>110,230,0,255</rgb>
</colorLinea>
<trazo class="basicStroke">
</trazo>
<colorRelleno>
<rgb>0,0,0,0</rgb>
</colorRelleno>
<imagenFondo></imagenFondo>
</estilo>
</entry>
26
6.8 Simbologas condicionales

CartoDroid permite definir reglas para calcular la simbologa que se debe aplicar a una entidad,
tanto a su geometria como a su label, utilizando las etiquetas symbologyExpression y
labelSymbologyExpression en la definicin de la capa en el fichero crtdrdLayers.xml se puede definir
una expresin SQL para determinar el identificador de la simbologa a utilizar (Ver apartado de
casos prcticos para ejemplos concretos).
Existe un mtodo alternativo para simbolizar en funcin de atributos, en la configuracin de la
capa se puede anidar un elemento symbologies, en el que definimos un elemento symbology por
cada simbologa diferente que queremos aplicar, y la expresin SQL para su clculo.
Por ejemplo en este caso vamos a simbolizar la capa de recintos SIGPAC por el capo de
c_uso_sigpac, pero en el caso del viedo queremos hacer diferencias utilizando el campo del
campo cap_auto.

<symbologies>
<es.jcyl.ita.crtcyl.core.model.style.ConditionalSymbology>
<id>ALICIA</id>
<name>Uso Forestal</name>
<condition>c_uso_sigpac = 'FO'</condition>
</es.jcyl.ita.crtcyl.core.model.style.ConditionalSymbology>
<id>JAIME</id>
<name>Improductivo</name>
<condition>c_uso_sigpac = 'IM'</condition>
<id>CAMILO</id>
<name>Tierra arable</name>
<condition>c_uso_sigpac = 'TA'</condition>
<id>PABLO</id>
<name>Viedo con CAP > 50%</name>
<condition>c_uso_sigpac = 'VI' AND CAP_AUTO > 50</condition>
<id>SOFIA</id>
<name>Viedo con CAP <= 50%</name>
<condition>c_uso_sigpac = 'VI' AND CAP_AUTO <= 50</condition>
</symbologies>

Estas reglas se aplican en el orden en el que son definidas en el XML, es decir, para cada
geometra se evalan las reglas en secuencia y se aplica la simbologa de la primera regla
satisfecha. En caso de no cumplir ninguno de los casos, se utiliza la simbologa por defecto de la
capa, la definida en el atributo symbId.
La ventaja respecto a utilizar la etiqueta symbologyExpression, es que al poder describir por
separado cada regla, y darle un nombre, desde cartodroid se puede utilizar esta informacin para
27
mostrar una leyenda del mapa. Al pulsar sobre el cuadro de la simbologa en la TOC, se abre una
pantalla con la descripcin de los estilos.
En las siguientes pantallas se puede ver cmo se aplican estas reglas sobre las capas de recintos
y la leyenda que se genera a partir de las reglas.
Leyenda calculada a partir de reglas de simbologa
Capa de recintos sigpac simbolizada por uso y por

coeficiente CAP
28
7. Configuracin de la visualizacin de formularios

CartoDroid permite definir la visualizacin que se le quiere dar a un formulario, y definir reglas
para determinar qu campos puede editar el usuario o qu reglas de validacin aplicar.
Para poder crear un formulario de edicin alfanumrica propio para una capa es necesario
establecer el atributo alphaEditFinisher de la capa como sigue:
<alphaEditFinisher>userFormAlphaEditFinisher</alphaEditFinisher>
Estableciendo este parmetro, CartoDroid buscar dentro de la carpeta cartodroid/values un

fichero con el nombre identificadordecapa_AlphaEdit.xml. Por ejemplo, para configurar un
formulario para la capa aforos, habr que crear un XML cartodroid/values/aforos_AlphaEdit.xml.
Nota: el fichero se almacena en un sistema de ficheros Android que es sensible a
minsculas/maysculas, el nombre del fichero debe empezar con exactamente el identificador de
la capa, luego si la capa se ha identificado como INSPECCIONES, el fichero debe llamarse
INSPECCIONES_AlphaEdit.xml.

El XML de configuracin del formulario tendr la siguiente organizacin:
Formulario (<form>): pantalla de edicin alfanumrica
o Grupo de pestaas (<tabs>), y para cada pestaa anidada (<tab>):
Grupo de campos de la pestaa (<fields>), y dentro de sta, por cada
campo a mostrar, tendremos una etiqueta <field>.
Un ejemplo de la organizacin del fichero XML:
<form>
<id>aforosForm</id>
<name>Aforos (Edicin)</name> 
<tabs class="linked-list">
<tab>
<id>tab1</id>
<name>Edicin</name> 
<fields class="linked-list">
<field>

</field>

</fields>
</tab>

</tabs>
</form>
29
7.2 Configuracin de campos del formulario
Etiqueta Descripcin
id Identificador nico del campo.
name Nombre que se mostrar para el campo.
type Tipo de campo, puede ser TEXT, COMBO, DATE, BOOLEAN, SEPARATOR, INFO.
Tipo de componente del campo TEXT: configurable en funcin de

http://developer.android.com/reference/android/text/InputType.html.
Por ejemplo, para configurar un campo de tipo numrico, con signo y
inputType
decimal, se pondra 12290 (2 + 4096 + 8192), equivalente a sumar los
valores de:
InputType.TYPE_CLASS_NUMBER (2)
InputType.TYPE_NUMBER_FLAG_SIGNED (4096)
InputType.TYPE_NUMBER_FLAG_DECIMAL (8192)
Expresin regular que debe cumplir el valor introducido por el usuario

regexp
para que valide correctamente. Slo es aplicable para campos de tipo
TEXT. Puede utilizarse para validar que el usuario introduzca valores
numricos, emails, telfonos, etc
hint Texto de ayuda para rellenar el campo.
extendedHint Texto extendido de ayuda para rellenar el campo.
persistedField
Nombre del campo de la BD que se utilizar para mostrar/almacenar la
informacin.
deletable Indica si se permite al usuario eliminar el valor del campo.
editable Indica si el campo es editable.
Valor por defecto del campo:

Para campos de tipo TEXT el valor por defecto ser un texto
Para campos de tipo COMBO el valor por defecto ser el cdigo
del combo a establecer (por ejemplo VI para Viedo), no el texto
defaultValue visible del combo
Para campos de tipo DATE el valor por defecto deber tener el
formato dd/MM/yyyy
Para campos de tipo BOOLEAN el valor por defecto ser true o
false (cualquier otro valor se interpretar como false)
Nota: Utilizando el tipo SEPARATOR es posible crear cabeceras intermedias para los datos, o bien
vacas (una lnea horizontal), o bien con un texto (rellenando el atributo name).
Nota: Aunque se hayan establecido como COMBO algunos de los valores, sigue siendo necesario
especificar de qu fichero de propiedades deben leerse los valores de dichos campos utilizando el
atributo valuesFromList del XML de configuracin de capas.
30
Ejemplo de definicin de varias pestaas

El siguiente trozo de cdigo define tres pestaas vacas, el usuario podr moverse de una a otra
desplazando lateralmente la pantalla.
<form>
<id>dopfigurasForm</id>
<name>Inspecciones DOP/IGP</name>
<tabs class="linked-list">
<tab>
<id>general</id>
<name>1.- General</name>
</tab>
<tab>
<id>obligatorios</id>
<name>2.- Obligatorios</name>
</tab>
<tab>
<id>facultativos</id>
<name>3.- Facultativos</name>
</tab>
</tabs>
</form>
Formulario con tres pestaas
Ejemplo de uso de campos booleanos

Con el siguiente trozo de XML, configuramos un apartado con tres capos booleanos para un
formulario de inspecciones. Para mostrar un control de tipo booleano el campo de la tabla debe
empezar por b_, ver el apartado de 9.2 -NOMENCLATURA DE LOS NOMBRES DE CAMPOS DE LAS
TABLAS.
<field>
<id>obl_separador2</id>
<name>Nombre registrado</name>
<type>SEPARATOR</type>
</field>
<field>
<id>b_oblig_nombre_aparece</id>
<name>Aparece en el etiquetado</name>
<hint>El nombre de la DOP/IGP debe aparecer en el etiquetado.</hint>
<type>BOOLEAN</type>
<persistedField>b_oblig_nombre_aparece</persistedField>
<editable>true</editable>
</field>
<field>
<id>b_oblig_nombre_logo_ue</id>
<name>Nombre registrado junto a logo UE</name>
<hint>El nombre de la DOP/IGP est en el mismo campo visual que el smbolo de la
Unin.</hint>
31
<persistedField>b_oblig_nombre_logo_ue</persistedField>
</field>
<field>
<id>b_oblig_nombre_mencion_igp</id>
<name>Va acompaado de mencin DOP/IGP</name>
<persistedField>b_oblig_nombre_mencion_igp</persistedField>
</field>
Uso de separador y componentes booleanos

Validacin de datos con expresin regular
El siguiente cdigo muestra cmo definir una validacin de un campo de correo electrnico:
<field>
<id>d_info_correo</id>
<name>Correo Electronico</name>
<hint></hint>
<type>TEXT</type>
<persistedField>d_info_correo</persistedField>
<regexp>^[_A-Za-z0-9-\+]+(\.[_A-Za-z0-9-]+)*@[A-Za-z0-9-]+(\.[A-Za-z0-9]+)*(\.[A-Za-
z]{2,})$</regexp>
</field>
Si el usuario no introduce un valor vlido, se mostrar un mensaje de error en el formulario.
Mensaje de error tras validacin de formulario

Otros ejemplos de expresiones regulares que pueden ser de utilidad:
Introducir un valor numrico de 2 decimales permitiendo separador de . o ,:
32
<regexp>\d+([\.,]\d{1,2})?</regexp>
Validacin bsica de DNI (solo formato no cdigo de control):

<regexp>[0-9]{7,8}[a-zA-Z]</regexp>
Validar la entrada para permitir solo values numricos 1, 2 o 3.

<field>
<id>d_tipo_instalacion</id>
<name>Tipo instalacion</name>
<hint></hint>
<type>TEXT</type>
<inputType>2</inputType>
<persistedField>d_tipo_instalacion</persistedField>
<regexp>(1|2|3)</regexp>
</field>
Para ms informacin sobre expresiones regulares:
https://docs.oracle.com/javase/tutorial/essential/regex/
33
8. Casos prcticos de parametrizacin de capas vectoriales
8.1 Configuracin de capa vectorial con mltiples ficheros

En este ejemplo utilizamos un implementador MultiSqlite para consultar varias bases de datos de
recintos. Con esta configuracin, CartoDroid buscar todas las bases de datos con el nombre
recintos_25830_2016_*.sqlite y mostrar la informacin como una nica capa.
<entry>
<string>rec_2016</string>
<attributesClassName>es.jcyl.ita.crtdrd.data.MultiSqlite</attributesClassName>
<id>recintos_2016</id>
<name>Recintos SIGPAC 2016</name>
<srs>25830</srs>
<vectorialType>30</vectorialType>
<sources>
<srid>25830</srid>
</sources>
<symbId>GREGORIO</symbId>
<range>
<max>21</max>
<min>17</min>
</range>
</entry>
8.2 Configuracin de capa vectorial con restricciones para la edicin

En este caso definimos una capa en la que no queremos que se pueda modificar la informacin,
para ello utilizamos las etiquetas editable, deletable, etc. de forma que desaparezcan del men
las opciones de modificacin de datos.
<entry>
<string>rec_2016</string>
<attributesClassName>es.jcyl.ita.crtdrd.data.MultiSqlite</attributesClassName>
<id>recintos_2016</id>
<name>Recintos SIGPAC 2016</name>
<srs>25830</srs>
<sources>
<srid>25830</srid>
</sources>
<symbId>GREGORIO</symbId>

34
<range>
<max>21</max>
<min>17</min>
</range>
<editable>false</editable>
<deletable>false</deletable>
<canCreate>false</canCreate>
<canPaste>false</canPaste>
<canSanitize>false</canSanitize>
</entry>
8.3 Definir una etiqueta dinmica

En el texto que se muestra asociado a una geometra en el mapa (etiqueta), CartoDroid por
defecto muestra el camo pk_uid de la tabla. El valor a mostrar se puede configurar para que se
calcule en base a los campos de la capa utilizando una expresin SQL.
Por ejemplo en este caso se mostrara el valor del campo variedad.
<labelExpression>variedad</labelExpression>
Pero tambin podemos aplicar funciones para que este valor se calcule en funcin de diferentes.
En este caso se utilizar como etiqueta de la geometra del municipio el cdigo y su descripcin
separados por un valor.
<labelExpression>cod_municipio || - || desc_municipio</labelExpression>
8.4 Cambiar la vista de identificacin de una entidad.

En este caso vamos a determinar qu campos queremos mostrar en el formulario de
identificacin, para ello podemos definir una expresin SQL directamente en la etiqueta
<sqlIdentity>.
Por ejemplo, en este caso, mostramos un campo numrico formateado a 2 decimales y aadimos
al final el texto %.
<sqlIdentify>*, ROUND(cobertura,2) || '%' as cobertura</sqlIdentify>
La etiqueta sqlIdentity sobrescribe la forma en

que cartodroid muestra la informacin de la
entidad, por ello, la configuracin anterior aade
* al principio, para que se muestren todos los
campos de la entidad y al final se aada el nuevo
campo (ver en siguiente figura).
Si queremos mostrar solo una parte de los
campos, podemos seleccionarlos directamente
con la expresin SQL. En este caso solo
mostramos cuatro campos al identificar:
<sqlIdentify>codigo, variedad,
ROUND(cobertura,2)|| '%' as cobertura
</sqlIdentify>
35
8.5 Cambiar la vista de la lista de entidades.

De igual forma que sqlIdentify permite modificar la informacin a mostrar al identificar una
entidad, sqlAsListView permite modificar la presentacin del listado de entidades.
Introduciendo la expresin del ejemplo anterior,

veremos que en el listado solo se muestran las
cuatro columnas seleccionadas.
<sqlAsListView>
codigo, variedad, ROUND(cobertura,2)|| '%' as
cobertura
</sqlAsListView>
De forma similar, podemos mostrar informacin en el listado (o en la identificacin) de una tabla

relacionada incluyendo una subquery como parte de la expresin.
<sqlAsListView>
*, (select nombre || ' ' || apellidos
from propietario p
where p.pk_uid = r.propietario_id)
as propietario
</sqlAsListView>
Con la expresin anterior, aadimos una consulta

para calcular el campo propietario obtenindolo de
una tabla Propietario que existe en la misma BD
que la tabla de la capa.
CartoDroid establece r como alias de la tabla
actual, por lo que se puede utilizar este alias para
hacer el join en la subconsulta.
8.6 Configurar filtros reutilizables para una capa

A la hora de trabajar con un proyecto es comn tener una serie de filtros reutilizables para mostrar
distintos grupos de informacin.
CartoDroid permite definir estos filtrados a nivel de capa estableciendo lo que habitualmente se
conoce como se definition queries. Para ello, definimos el fichero
cartodroid/values/<ID_DE_CAPA>DefinitionQueries.properties.
El fichero contendr el nombre que aparecer en el desplegable de filtros y la definition query que
se establecer. Por ejemplo si establecemos el fichero /cartodroid/values/
plantacionesDefinitionQueries.properties el siguiente contenido:
Cobertura >10% = cobertura>0.1
Cobertura >20% = cobertura>0.2
Veremos que en las opciones de filtrado de la capa aparece un desplegable de Filtros ms

usados, y al abrirlo aparecern las opciones incluidas en el fichero.
36
En definitiva el texto introducido en el fichero de definition queries, se aplica directamente a la

clusula where de la consulta de las entidades, por lo que se pueden hacer consultas ms
complejas, que por ejemplo apliquen expresiones booleanas sobre los campos:
Condicion especial=(variedad = 'PA' and sistcond = 'V') or (variedad = 'VE' and marco1 >= 3)
O cruzar con otra tabla para establecer la condicin en base a campos de la tabla referida, por
ejemplo para mostrar solo las parcelas de los propietarios asociados:
Asociados=exists(select 1 from propietario p where p.pk_uid = r.propietario_id and p.asociado
= 'S')
8.7 Configurar nombres de las imgenes tomadas con CartoDroid

Es posible configurar los nombres de las imgenes de las entidades mediante una expresin SQL
sobre la entidad. Para ello, se puede usar la etiqueta <labelPictureExpression>, esta etiqueta
define el prefijo que se asociar al archivo de la imagen.
<labelPictureExpression>pk_uid||'-'||c_refrec</labelPictureExpression>
8.8 Configuracin de lista desplegable para campo de la tabla

En este caso incluimos en una capa de trabajo una configuracin de desplegable, para que el
valor de los campos variedad y sistCond se seleccionen con desplegables.
<entry>
<string>plantaciones</string>
<id>plantaciones</id>
<nombre>plantaciones</nombre>
<sources>
<dbURL>/storage/emulated/0/CartoDroid/data/plantaciones.sqlite</dbURL>
</sources>
<symbId>REBECA</symbId>

<labelRange>
<max>21</max>
<min>10</min>
</labelRange>
<range>
37
<max>21</max>
<min>10</min>
</range>
<srs>25830</srs>
<valuesFromList>variedad=variedades;sistCond=sistemas</valuesFromList>
</entry>
La definicin del contenido de los desplegables se hace mediante fichero de propiedades, en el

directorio cartodroid/values, debe existir un fichero variedades.properties y sistemas.properties que
contendrn la relacin de valores a mostrar y para cada valor, el cdigo que se debe almacenar
en la BD en el campo.
CA=Cabernet E=E
GA=Carnacha V=V
ME=Merlot X=X
PA=Palomino
SA=Sauvignon Blanc
TE=Tempranillo
VE=Verdejo
VI=Viura
Contenido fichero variedades.properties Contenido fichero

sistemas.properties
En el formulario, al seleccionar el campo para introducir un valor, se mostrar un listado con los
valores definidos en el correspondiente fichero:
8.9 Simbolizacin de entidades por expresin

En este caso utilizamos el atributo symbologyExpression para calcular el estilo que se debe aplicar a
cada entidad en funcin del valor variedad.
<entry>
<string>insp</string>
<id>insp</id>
<nombre>CAP</nombre>
<descripcion>CAP 2015</descripcion>
<simbologia>REBECA</simbologia>
38
<origenes>
<dbURL>dorueda.sqlite</dbURL>
</origenes>
<rango>
<max>21</max>
<min>0</min>
</rango>
<srs>25830</srs>

<labelExpression>variedad</labelExpression>
<symbologyExpression>case when variedad = 'PA' then 'ALICIA'
when variedad = 'VI' then 'CARLA'
when variedad = 'VE' then 'CAMILO'
when variedad = 'TE' then 'ANA'
when variedad = 'SA' then 'JUAN'
when variedad = 'GA' then 'JAIME'
when variedad = 'CA' then 'IRENE'
when variedad = 'ME' then 'SOFIA'
else 'REBECA' end</symbologyExpression>
</entry>
Este sera el resultado, una capa en la que las geometras se muestran con distinta apariencia en
funcin del atributo variedad.
39
8.10 Cambiar los markers por defecto de las simbologas puntuales

Es posible modificar la simbologa por defecto de los markers (entidades puntuales).
Para ello, se debe meter el icono deseado en el directorio symbol del directorio CartoDroid del
dispositivo, y configurar la simbologa puntual de la siguiente manera en el archivo
crtdrdSymbologies*.xml.
<symbologyConf>
<estilos>
<entry>
<string>symbTopilloOK</string>
<estilo class="estiloMarca">
<id>symbTopilloOK</id>
<urlImagen>topillo_ok.png</urlImagen>
<color>
<rgb>0,255,255,255</rgb>
</color>
</estilo>
</entry>
</estilos>
<simbologias>
<entry>
<string>symbTopilloOK</string>
<symb class="punto">
<id>symbTopilloOK</id>
<idEstiloPunto>symbTopilloOK</idEstiloPunto>
</symb>
</entry>
</simbologias>
</symbologyConf>
8.11 Mostrar puntas de flecha en las entidades lineales

Para mostrar puntas de flecha en las entidades lineales (para marcar el sentido de grabacin), se debe
aadir la siguiente etiqueta en la capa:
<showArrowHeads>true</showArrowHeads>
40
9. Sobre las capas SQLite-Spatialite en CartoDroid
9.1 Requisitos
Requisitos que debe cumplir una capa spatialite para poder ser utilizada en CartoDroid:
La capa debe tener correctamente definido el sistema de referencia.
La tabla debe tener un campo de clave primaria con el nombre pk_uid.
El campo que contiene la geometra en la tabla se debe llamar Geometry (con G en
mayscula).
Para dar robustez a la edicin, es conveniente utilizar tipos de datos multiparte:
MULTIPOLYGON, MULTILINESTRING, MULTIPOINT.
Esto se puede forzar con la siguiente sentencia:
update geometry_columns set type = 'MULTIPOLYGON' where f_table_name = 'inspeccion'
Si ya existen entidades en la capa, podemos modificar su tipo utilizando la siguiente

sentencia:
update inspeccion set Geometry = CastToMultiPolygon(Geometry);
9.2 Nomenclatura de los nombres de campos de las tablas

Para mostrar un componente de tipo checkbox en un formulario, el nombre del campo
deber de comenzar por b_, y se definir en la tabla como tipo entero. CartoDroid
almacenar el valor del checkbox como 1 o 0.
Para mostrar un componente de tipo fecha, el nombre del campo deber de comenzar por
f_, y se almacenar en la base de datos como un double (timestamp).
41

CartoDroid Manual de Referencia v0 44 X

Загружено:

Сведения о документе

Исходное описание:

Оригинальное название

Авторское право

Доступные форматы

Поделиться этим документом

Поделиться или встроить документ

Параметры публикации

Этот документ был вам полезен?

Это неприемлемый материал?

Авторское право:

Доступные форматы

CartoDroid Manual de Referencia v0 44 X

Загружено:

Авторское право:

Доступные форматы

CartoDroid

Instituto Tecnolgico Agrario de

8.6 Configurar filtros reutilizables para una capa ............................................................................. 36

2. Estructura de ficheros de la aplicacin.

CONFIG DATA VALUES TEMP PICTURES

3. Creacin de capas desde CartoDroid

2. Pulsando el botn Aadir capa. Se abrir el dialogo de creacin de capas.

3. Seleccionamos la opcin Crear una nueva capa vectorial y aparecer el siguiente

a) En la parte superior se muestran campos bsicos de

b) Inmediatamente despus, aparece una seleccin de

c) En el siguiente apartado, dentro del mismo formulario, el

d) Por ltimo, se debe seleccionar la simbologa de la capa. La

4. Gestin de proyectos con CRTDRD

La configuracin de un proyecto CartoDroid se apoya principalmente en dos ficheros almacenados

crtdrdSymbologies.<id_proyecto>.xml: fichero de configuracin de simbologas

5. Configuracin de capas en proyectos

5.1 Estructura general del fichero

Un ejemplo de este fichero:

5.2 Configuracin de capa Vectorial

nombre Nombre visible de la capa en la TOC.

descripcion Descripcin de la capa a mostrar en la TOC.

orden Posicin en la capa en el listado de capas de la TOC.

labels Indica si las etiquetas deben renderizarse por defecto: true|false.

Expresin SQL a ejecutar para calcular la etiqueta ej:

Identificador de simbologa a aplicar por defecto a las geometras de una

Identificador de simbologa a aplicar por defecto a las etiquetas de una

symbologyExpression Expresin que se utilizar para calcular la simbologa de las entidades de

labelSymbologyExpress Expresin que se utilizar para calcular la simbologa de las etiquetas de

Permisos y operaciones a nivel de capa

allowOverlaps Si se pueden crear geometras con solapes dentro de la misma capa.

canChangeSymbology Si se permite modificar la simbologa de la capa. true|false.

canCopy Si se pueden copiar los elementos de una capa en otras. true|false.

canCreate Si se permite crear nuevos elementos en la capa. true|false.

canDieCut Determina si se pueden troquelar las entidades de la capa. true|false.

canExplode Si se permite utilizar la operacin de Explotar geometras en la capa.

canPaste Si se permiten pegar geometras en la capa. true|false.

canSanitize Si debe aparecer el botn Limpiar los datos de la capa en la TOC.

canZoomVisibles Si se debe mostrar el botn Hacer zoom a elementos visibles en la TOC.

deletable Si se permite eliminar una entidad de la capa. true|false.

identificable Si se operacin de identificacin debe estar activa para la capa. true |

Determina si se puede configurar la capa (nombre, descripcin,

layerRemovable Si se puede eliminar la tabla de la TOC. true|false.

selectable Si las entidades de la capa pueden seleccionarse. true|false.

visible Si la capa es visible o no en la TOC. true|false.

Origen de informacin de la capa

Define el origen de datos para localizar la base de datos o fichero en el

Relaciona los campos del formulario que mostrarn un desplegable de

Para el campo C_USO_SIGPAC de la capa se mostrarn los valores

Que tendr el formato <cdigo>=<valor>:

sqlIdentify Consulta que se va a ejecutar para la identificacin.

sqlAsListView Consulta que se ejecutar para mostrar la lista de entidades

Consulta sql que se ejecutar para filtrar las entidades. El texto

5.3 Configuracin de capa Raster

nombre Nombre visible de la capa en la TOC.

descripcion Descripcin de la capa a mostrar en la TOC.

orden Posicin en la capa en el listado de capas de la TOC.

Permisos y operaciones a nivel de capa

layerRemovable Si se puede eliminar la tabla de la TOC. true|false.

visible Si la imagen raster es visible o no.

Origen de informacin de la capa

sources Define el origen de datos para localizar la base de datos o fichero en el

datos. Dentro de esta etiqueta se incluir uno de los siguientes