Convenciones datos.gob.es

Introducción#

En España, el intercambio de datos abiertos entre el portal de la Iniciativa de datos abiertos del Gobierno de España (datos.gob.es) y los distintos proveedores de datos, como catálogos de la Administración General del Estado, autonómicos, de Entidades Locales y otros organismos, se plantea bajo un marco que asegure la interoperabilidad y homogeneidad de los metadatos. Para ello, se adapta el perfil de aplicación europeo DCAT-AP 2.1.1 junto a los elementos descritos en la extensión DCAT-AP HVD 2.2.0 para incorporar el modelado de los Conjuntos de datos de alto valor (High Value Datasets) a las necesidades nacionales, dando lugar al estándar DCAT-AP-ES, que se establece como referencia para el intercambio de metadatos sobre información pública a nivel nacional.

Desde la entrada en vigor del estándar, datos.gob.es acepta metadatos en formato DCAT-AP-ES, así como el perfil de aplicación referido en la Norma Técnica. Para aquellos proveedores que federen directamente al portal se establecerá un período transitorio tras la publicación de nuevas versiones, durante el cual podrán ajustar sus sistemas al estándar actualizado desde el perfil anterior de la Norma Técnica de Interoperabilidad de Recursos de Información del Sector Público (NTI-RISP)

La guía de convenciones no solo detalla las modificaciones específicas introducidas en el estándar español respecto a la versión europea, sino que también define reglas adicionales para abordar necesidades prácticas. Estas pueden incluir particularidades del contexto español de datos abiertos, donde la implementación podría ajustarse a requerimientos técnicos distintos. Además, se prevé que algunas de estas reglas puedan evolucionar más rápidamente que la especificación principal, permitiendo mayor flexibilidad y adaptación a los cambios tecnológicos.

Este documento tiene como público objetivo a los responsables de desarrollo y mantenimiento de los portales de datos abiertos, así como a los proveedores de datos que colaboren con el catálogo nacional. Su propósito es proporcionar directrices claras y herramientas prácticas para implementar el estándar de manera eficiente. Sin embargo, para usos en contextos específicos, se deja abierta la posibilidad de establecer convenciones adicionales que complementen las normativas generales.

Para asegurar una interpretación uniforme, se utilizan términos normativos como DEBE (MUST), DEBERÍA (SHOULD) y PUEDE (MAY), conforme a lo establecido en el estándar RFC2119, con el fin de diferenciar las directrices obligatorias de las opcionales. Aunque el manual incluye diagramas y ejemplos ilustrativos, estos no tienen carácter normativo, a menos que se indique explícitamente.

Este enfoque busca no solo estandarizar el intercambio de metadatos, sino también fomentar una mayor armonización y colaboración entre los diferentes niveles de gobierno en España, garantizando una interoperabilidad sólida y escalable.

Prefijos usados#

Todos los prefijos de espacios de nombres (namespaces) utilizados a lo largo del documento se encuentran referenciados en el Anexo 4. Espacios de nombres utilizados en el documento.

Tipos de convenciones#

Convenciones técnicas#

Estas convenciones definen aspectos técnicos de implementación, incluyendo codificación, identificación de recursos y modelado de entidades. Son esenciales para garantizar la interoperabilidad técnica y la correcta interpretación de los metadatos.

Convenciones organizativas#

Estas convenciones establecen reglas para la gestión y organización de catálogos, la federación de datos y la identificación de organismos. Proporcionan el marco de gobernanza necesario para una gestión efectiva de los metadatos.

Convenciones semánticas#

Estas convenciones aseguran la coherencia en la descripción de los recursos, garantizan que los metadatos sean semánticamente precisos y consistentes.

Lista de convenciones#

• Convención 01: El identificador del publicador DEBE estar dado de alta y disponible en la taxonomía de datos.gob.es
• Convención 02: Los literales dct:title, dct:description, vcard:organization_name, vcard:fn, foaf:name, dcat:keyword y adms:versionNotes DEBEN estar definidos con las etiquetas de idioma, al menos estar en idioma español es y no pueden ser literales vacíos.
• Convención 03: Los identificadores y referencias URI DEBERÍAN utilizar el esquema http:// en lugar de https:// como norma general.
• Convención 04: Los organismos DEBERÍAN implementar la federación automática mediante RDF como único método de publicación de metadatos en formato DCAT-AP-ES, evitando la coexistencia de federación manual y automática para un mismo organismo.
• Convención 05: Las URIs DEBEN estar correctamente codificadas en su origen, especialmente cuando contengan: 1. Caracteres reservados (?, &, =, #, etc.) 2. Espacios 3. Caracteres no ASCII (acentos, ñ, etc.) 4. Caracteres especiales (<, >, ", {, }, |, \, ^, ~, [, ], `)
• Convención 06: Los recursos DEBEN tener un identificador único y persistente que cumpla los siguientes requisitos: 1. Incluir la propiedad dct:identifier con un valor único para cada recurso. 2. Mantener la coherencia del identificador aunque el recurso se actualice. 3. Usar el mismo identificador cuando el recurso se publique en diferentes catálogos.
• Convención 07: Las referencias a documentos legales DEBEN utilizar identificadores ELI cuando estén disponibles: 1. Para legislación europea: http://data.europa.eu/eli/... 2. Para legislación nacional: https://www.boe.es/eli/... 3. Para documentos derivados usar la URI ELI del documento principal
• Convención 08: Las fechas de creación y modificación de recursos DEBEN cumplir los siguientes requisitos: 1. La fecha de modificación (dct:modified) DEBE ser posterior a la fecha de creación (dct:created) 2. La fecha de modificación DEBE reflejar el último cambio en los datos, no en los metadatos
• Convención 09: Se DEBE utilizar un único catálogo por organismo publicador, evitando el uso de subcatálogos mediante dct:hasPart. Las relaciones entre recursos DEBEN modelarse usando las siguientes propiedades según corresponda.
• Convención 10: El catálogo DEBE incluir como mínimo la taxonomía de sectores primarios en la propiedad dcat:themeTaxonomy.
• Convención 11: Se PUEDEN incluir taxonomías adicionales para mejorar la clasificación de los datasets: http://publications.europa.eu/resource/authority/data-theme o http://inspire.ec.europa.eu/theme
• Convención 12: Los datasets catalogados como HVD DEBEN incluir al menos un servicio de datos (dcat:DataService) con las siguientes propiedades obligatorias: 1. URL del endpoint (dcat:endpointURL) 2. Descripción del endpoint (dcat:endpointDescription) 3. Punto de contacto (dcat:contactPoint) 4. Legislación aplicable (dcatap:applicableLegislation) 5. Categoría HVD (dcatap:hvdCategory) 6. Documentación (foaf:page) 7. Datasets servidos (dcat:servesDataset)
• Convención 13: Los servicios OGC DEBERÍAN modelarse como dcat:DataService en lugar de dcat:Distribution.
• Convención 14: La información de publicador DEBERÍA contener un código identificador DIR3 en la propiedad identificador (dct:identifier), por ejemplo: EA0000000
• Convención 15: La información de creador DEBERÍA contener un código identificador DIR3 en la propiedad identificador (dct:identifier), por ejemplo: EA0000000
• Convención 16: La cobertura geográfica DEBE declararse utilizando las URIs del Anexo V de la NTI-RISP para recursos geográficos del territorio español, siguiendo estas reglas: 1. Utilizar el nivel territorial más específico que corresponda al ámbito real del dataset. 2. Evitar el uso de España por defecto cuando el ámbito sea más reducido. 3. No declarar simultáneamente una Comunidad Autónoma y sus provincias. 4. Para Comunidades Autónomas uniprovinciales, utilizar preferentemente la referencia a la Comunidad Autónoma.
• Convención 17: Cuando se especifique la cobertura geométrica, se DEBERÍA usar WKT (según GeoSPARQL).
• Convención 18: Los datasets DEBEN incluir al menos un punto de contacto (dcat:contactPoint) con las siguientes propiedades obligatorias: Correo electrónico (vcard:hasEmail) o URL del formulario de contacto (vcard:hasURL)
• Convención 19: El punto de contacto DEBERÍA incluir también: 1. Denominación del área o persona (vcard:fn) 2. Número de teléfono (vcard:hasTelephone) 3. Identificador del organismo (vcard:hasUid)
• Convención 20: Los puntos de contacto recogidos en la taxonomía del portal DEBEN describirse como un vcard:Kind y no directamente con la URI del organismo.
• Convención 21: En las distribuciones de servicios OGC, las URLs de acceso DEBEN modelarse de la siguiente manera: En dcat:accessURL: URL completa de la petición de capacidades del servicio GetCapabilities (ej: http://example.org/wms?request=GetCapabilities&service=WMS) y en dct:conformsTo: URL del estándar OGC correspondiente, ej: http://www.opengeospatial.org/standards/wms
• Convención 22: Los periodos temporales DEBEN ser descritos exclusivamente mediante las propiedades dcat:startDate y dcat:endDate dentro de dct:temporal.

Convenciones generales#

El organismo debe disponer de identificador dado de alta en la taxonomía de datos.gob.es#

Para garantizar la trazabilidad de los organismos publicadores, éstos deben estar dados de alta y disponibles en la taxonomía de datos.gob.es, ya sea como DIR3 de organismo público u organismo privado cuyo identificador es la letra P seguida de su NIF cómo código ficticio (ver Anexo 3. Mapeo de identificadores organizativos).

Indicación de idioma español en declaraciones#

Los campos de literales de etiquetas multilingüe xml:lang deben estar al menos en idioma español (es).

Uso de URIs HTTP#

Para mantener la compatibilidad y evitar problemas de interoperabilidad con sistemas que no soporten TLS/SSL, se recomienda usar URIs HTTP en lugar de HTTPS en los identificadores y referencias. Las URIs HTTP son igualmente derreferenciables que HTTPS mediante redirección.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20

@prefix dcat: <http://www.w3.org/ns/dcat#> .
@prefix dct: <http://purl.org/dc/terms/> .

# ✅ Uso recomendado general con HTTP
<http://datos.gob.es/catalogo/dataset/001>
    a dcat:Dataset ;
    dct:publisher <http://datos.gob.es/recurso/sector-publico/org/Organismo/EA0000000> ;
    dcat:theme <http://publications.europa.eu/resource/authority/data-theme/TECH> .

# ✅ Excepción para ELIs del BOE
<http://datos.gob.es/catalogo/dataset/002>
    a dcat:Dataset ;
    dct:publisher <http://datos.gob.es/recurso/sector-publico/org/Organismo/EA0000000> ;
    dcatap:applicableLegislation <https://www.boe.es/eli/es/rdlg/2001/07/20/1> .

# ❌ Uso no recomendado con HTTPS
<https://datos.gob.es/catalogo/dataset/001>
    a dcat:Dataset ;
    dct:publisher <https://datos.gob.es/recurso/sector-publico/org/Organismo/EA0000000> ;
    dcat:theme <https://publications.europa.eu/resource/authority/data-theme/TECH> .

Federación automática de datos#

Para garantizar la consistencia y calidad de los metadatos, así como simplificar el proceso de federación, se establece el uso exclusivo de federación automática mediante RDF (DCAT-AP-ES) como único método de ingesta de datos en el portal.

Codificación de URIs#

Para garantizar la validez del RDF y evitar problemas de procesamiento, todas las URIs deben estar correctamente codificadas según la RFC 3986.

1
2
3
4
5
6
7
8
9

 @prefix dcat: <http://www.w3.org/ns/dcat#> .

# ✅ URI correctamente codificada
<https%3A%2F%2Fwww.ine.es%2Fdyngs%2FINEbase%2Foperacion.htm%3Fc%3DEstadistica_C%26menu%3Dresultados> 
    a dcat:Dataset .

# ❌ URI sin codificar (incorrecto)
<https://www.ine.es/dyngs/INEbase/operacion.htm?c=Estadistica_C&menu=resultados> 
    a dcat:Dataset .

Identificadores únicos y persistentes#

Para garantizar la correcta identificación y trazabilidad de los recursos a lo largo del tiempo, así como evitar duplicidades durante la federación desde múltiples fuentes, es necesario establecer un sistema de identificadores únicos y persistentes dado que el identificador (dct:identifier) es la propiedad que permite la identificación única e inequívoca del conjunto de datos.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

@prefix dcat: <http://www.w3.org/ns/dcat#> .
@prefix dct: <http://purl.org/dc/terms/> .

# Dataset en el catálogo de datos abiertos 
<http://datos.comunidad.es/dataset/medioambiente/calidad-aire-2024>
    a dcat:Dataset ;
    dct:identifier "MA-AIRE-2024" ;
    dct:title "Calidad del aire 2024"@es .

# El mismo dataset en el catálogo CSW (conforme a GeoDCAT-AP)
<https://ide.comunidad.es/catalogo/dataset/calidad-aire-2024> 
    a dcat:Dataset ;
    dct:identifier "MA-AIRE-2024" ;
    dct:title "Calidad del aire 2024"@es .

Identificadores ELI para documentos legales#

Para garantizar una referencia unívoca y persistente a documentos legales, se debe utilizar el Identificador Europeo de Legislación (ELI) como URI estándar.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

@prefix dcat: <http://www.w3.org/ns/dcat#> .
@prefix dct: <http://purl.org/dc/terms/> .
@prefix dcatap: <http://data.europa.eu/r5r/> .

# Referencia a legislación comunitaria (UE)
<http://example.org/dataset/1> a dcat:Dataset ;
    dcatap:applicableLegislation <http://data.europa.eu/eli/reg_impl/2023/138/oj> ;
    dct:conformsTo <http://data.europa.eu/eli/dir/2007/2/2021-06-27> .
    ...

# Referencia a legislación nacional (España)
<http://example.org/dataset/2> a dcat:Dataset ;
    dct:conformsTo <https://www.boe.es/eli/es/l/2007/12/16/37/con> .
    ...

Gestión de fechas de creación y modificación#

Para garantizar la trazabilidad temporal de los recursos y su correcto seguimiento, es importante gestionar adecuadamente las fechas de creación y modificación.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

@prefix dcat: <http://www.w3.org/ns/dcat#> .
@prefix dct: <http://purl.org/dc/terms/> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

# Ejemplo de gestión correcta de fechas
<http://example.org/dataset/1> a dcat:Dataset ;
    dct:title "Dataset ejemplo"@es ;
    dct:created "2025-01-01"^^xsd:date ;
    dct:modified "2025-01-30"^^xsd:date .

# Ejemplo con precisión horaria
<http://example.org/dataset/2> a dcat:Dataset ;
    dct:title "Dataset con hora"@es ;
    dct:created "2025-01-01T10:00:00Z"^^xsd:dateTime ;
    dct:modified "2025-01-30T15:30:00Z"^^xsd:dateTime .

Especificación de períodos temporales#

La propiedad dct:temporal en DCAT-AP-ES se usa para describir el periodo de tiempo al que se refiere un conjunto de datos. En la actualidad, existen múltiples formas de describir esta información, incluyendo el uso de dcat:startDate, dcat:endDate, time:hasBeginning, time:hasEnd y schema:startDate, schema:endDate. Sin embargo, esta flexibilidad puede generar inconsistencias en la representación de los periodos temporales.

Dado que tanto dcat:startDate como dcat:endDate pueden registrarse con rangos suficientemente flexibles, se opta por adoptar este enfoque por motivos organizativos.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

@prefix dcat: <http://www.w3.org/ns/dcat#> .
@prefix dct: <http://purl.org/dc/terms/> .

<http://datos.comunidad.es/dataset/medioambiente/calidad-aire-2024>
    a dcat:Dataset ;
    dct:title "Calidad del aire 2024"@es ;
    dct:temporal [
        a dct:PeriodOfTime ;
        dcat:startDate "2024-01-01T00:00:00Z"^^xsd:dateTime ;
        dcat:endDate "2024-12-31T23:59:59Z"^^xsd:dateTime
    ] .

Convenciones para dcat:Catalog#

Subcatálogos y relaciones entre recursos (dct:hasPart)#

Para mantener la simplicidad y evitar problemas de ambigüedad en la federación de catálogos, se recomienda utilizar un único catálogo por organismo y expresar las relaciones entre recursos mediante las subpropiedades específicas de dcterms:relation.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

@prefix dcat: <http://www.w3.org/ns/dcat#> .
@prefix dct: <http://purl.org/dc/terms/> .

# Catálogo único por organismo
<http://datos.gob.es/catalogo/org/EA0000000>
    a dcat:Catalog ;
    dct:title "Catálogo de datos abiertos"@es ;
    dct:publisher <http://datos.gob.es/recurso/sector-publico/org/Organismo/EA0000000> ;
    dcat:dataset <http://datos.gob.es/catalogo/dataset/001> ;
    dcat:service <http://datos.gob.es/catalogo/dataset/001/service/1> .

# Dataset con múltiples relaciones
<http://datos.gob.es/catalogo/dataset/001>
    a dcat:Dataset ;
    dct:title "Dataset principal"@es ;
    # Distribución del dataset
    dcat:distribution <http://datos.gob.es/catalogo/dataset/001/distribution/1> ;
    # Nueva versión del dataset
    dct:hasVersion <http://datos.gob.es/catalogo/dataset/001/v2> ;
    # Dataset relacionado (semántica específica)
    dct:isPartOf <http://datos.gob.es/catalogo/dataset/000> ;
    # Recurso relacionado (semántica general)
    dct:relation <http://datos.gob.es/recurso/relacionado/xyz> .

Taxonomías temáticas (dcat:themeTaxonomy)#

Los catálogos deben incluir al menos la taxonomía de sectores primarios para clasificar sus datasets. Se pueden incluir alguna de las dos taxonomías adicionales para enriquecer la clasificación, se incluye información sobre mapeos entre Sectores NTI-RISP y Temáticas DCAT-AP (Anexo 1), así como entre Temáticas DCAT-AP y Temas INSPIRE (Anexo 2)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

@prefix dcat: <http://www.w3.org/ns/dcat#> .
@prefix dct: <http://purl.org/dc/terms/> .

# Ejemplo de catálogo con múltiples taxonomías
<http://dcat-ap-es.ejemplo.org/catalogo>
    a dcat:Catalog ;
    dct:title "Catálogo de datos abiertos"@es ;
    dcat:themeTaxonomy <http://datos.gob.es/kos/sector-publico/sector>, # Taxonomía obligatoria
        <http://inspire.ec.europa.eu/theme>,                            # Taxonomía adicional: Temas INSPIRE
        <http://publications.europa.eu/resource/authority/data-theme> ; # Taxonomía adicional: Temáticas de datos (DCAT-AP)

Convenciones para dcat:DataService#

Servicios de datos HVD (dcat:DataService)#

Los conjuntos de datos de alto valor (HVD) deben proporcionar acceso programático a sus datos mediante APIs. La especificación de servicios de datos se realiza mediante la clase dcat:DataService asociada a las distribuciones del dataset a través de dcat:accessService.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

@prefix dcat: <http://www.w3.org/ns/dcat#> .
@prefix dct: <http://purl.org/dc/terms/> .
@prefix dcatap: <http://data.europa.eu/r5r/> .
@prefix foaf: <http://xmlns.com/foaf/0.1/> .
@prefix vcard: <http://www.w3.org/206/vcard/ns#> .
@prefix cnt: <http://www.w3.org/2011/content#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

<https://example.org/catalogo/dataset/43bc8990-f9f1-5527-8134-459b1a1cce92/resource/37cfdf38-91cd-4107-a63c-72c739dd41cd> a dcat:Distribution ;
    dcatap:applicableLegislation <http://data.europa.eu/eli/reg_impl/2023/138/oj> ;
    dct:accessRights <http://publications.europa.eu/resource/authority/access-right/PUBLIC> ;
    dct:format <http://publications.europa.eu/resource/authority/file-type/CSV> ;
    dct:issued "2024-12-17T00:00:00"^^xsd:dateTime ;
    dct:license <https://publications.europa.eu/resource/authority/licence/CC_BY_4_0> ;
    dct:modified "2024-12-17"^^xsd:date ;
    dct:title "Sample CSV" ;
    cnt:characterEncoding "UTF-8" ;
    dcat:accessService [ a dcat:DataService ;
        dct:title "Example Server" ;
        dcat:theme <http://datos.gob.es/kos/sector-publico/sector/medio-ambiente> ;
        dct:publisher <http://datos.gob.es/recurso/sector-publico/org/Organismo/EA0000000> ;
        dcat:endpointURL <https://example.org/endpoint> ;
        dcat:endpointDescription <https://example.org/endpoint/description> ;
        dcat:contactPoint [
            a vcard:Kind ;
            vcard:fn "Oficina de Datos Abiertos"@es ;
            vcard:hasUid "EA0000000" ;
            vcard:hasEmail <mailto:datos@example.org> ;
            vcard:hasTelephone <tel:+34-912345678> ;
            vcard:hasURL <https://example.org/contacto> 
        ] ;
        dcatap:applicableLegislation <http://data.europa.eu/eli/reg_impl/2023/138/oj> ;
        dcatap:hvdCategory <http://data.europa.eu/bna/c_dd313021> ;
        foaf:page <https://dcat-ap-es.ejemplo.org/api/sla.html> ;
        dct:accessRights <http://publications.europa.eu/resource/authority/access-right/PUBLIC> ;
        dcat:servesDataset <https://example.org/catalogo/dataset/43bc8990-f9f1-5527-8134-459b1a1cce92>,
            <https://example.org/catalogo/dataset/43bc8990-g3jd-5527-8134-459b1a1jdk88>
    ];
    dcat:accessURL <https://example.org/catalogo/es/dataset/43bc8990-f9f1-5527-8134-459b1a1cce92/resource/37cfdf38-91cd-4107-a63c-72c739dd41cd> ;
    dcat:downloadURL <https://example.org/catalogo/es/dataset/43bc8990-f9f1-5527-8134-459b1a1cce92/resource/37cfdf38-91cd-4107-a63c-72c739dd41cd/download> ;
    dcat:mediaType <http://www.iana.org/assignments/media-types/text/csv> .

Modelado de Servicios OGC#

Para mejorar la interoperabilidad y descripción de servicios OGC (WMS, WFS, WMTS, CSW, etc.), estos deben modelarse usando dcat:DataService en lugar de dcat:Distribution.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

@prefix dcat: <http://www.w3.org/ns/dcat#> .
@prefix dct: <http://purl.org/dc/terms/> .
@prefix dcatap: <http://data.europa.eu/r5r/> .
@prefix foaf: <http://xmlns.com/foaf/0.1/> .

<http://example.org/dataset/1> a dcat:Dataset ;
    dct:title "Dataset de ejemplo"@es ;

    ...

<http://example.org/services/wms/1> a dcat:DataService ;
    dct:title "Servicio WMS de ejemplo"@es ;
    dcat:theme <http://datos.gob.es/kos/sector-publico/sector/medio-ambiente> .
    dct:publisher <http://datos.gob.es/recurso/sector-publico/org/Organismo/EA0000000> ;
    dcat:endpointURL <http://example.org/geoserver/wms> ;
    dcat:endpointDescription <http://example.org/geoserver/wms?request=GetCapabilities> ;
    dcat:contactPoint [
        a vcard:Kind ;
        vcard:fn "Oficina de Datos Abiertos"@es ;
        vcard:hasUid "EA0000000" ;
        vcard:hasEmail <mailto:datos@example.org> ;
        vcard:hasTelephone <tel:+34-912345678> ;
        vcard:hasURL <https://example.org/contacto>
    ] ;
    dcatap:applicableLegislation <http://data.europa.eu/eli/reg_impl/2023/138/oj> ;
    dcatap:hvdCategory <http://data.europa.eu/bna/c_dd313021> ;
    foaf:page <http://example.org/services> ;
    dct:accessRights <http://publications.europa.eu/resource/authority/access-right/PUBLIC> ;
    dcat:servesDataset <http://example.org/dataset/1> .

Convenciones para dcat:Dataset#

Publicador (dct:publisher)#

La trazabilidad del publicador debería venir determinada por el identificador de organismos del sector público disponible en el Directorio Común de unidades orgánicas y oficinas (DIR3) siempre y cuando este disponible.

Creador (dct:creator)#

La trazabilidad del creador debería venir determinada por el identificador de organismos del sector público disponible en el Directorio Común de unidades orgánicas y oficinas (DIR3) siempre y cuando este disponible.

Cobertura geográfica (dct:spatial)#

La cobertura geográfica de un conjunto de datos debe describirse de la manera más precisa posible utilizando los identificadores correspondientes a los recursos geográficos del territorio español descritos en el Anexo V de la NTI-RISP.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

@prefix dct: <http://purl.org/dc/terms/> .

# ✅ Dataset de ámbito nacional
dct:spatial <http://datos.gob.es/recurso/sector-publico/territorio/Pais/España> .

# ✅ Dataset de ámbito autonómico
dct:spatial <http://datos.gob.es/recurso/sector-publico/territorio/Autonomia/Andalucia> .

# ✅ Dataset de ámbito provincial
dct:spatial <http://datos.gob.es/recurso/sector-publico/territorio/Provincia/Valladolid> .

# ✅ Dataset con múltiples ámbitos no redundantes
dct:spatial <http://datos.gob.es/recurso/sector-publico/territorio/Autonomia/Aragon> ;
dct:spatial <http://datos.gob.es/recurso/sector-publico/territorio/Autonomia/Cataluna> .

1
2
3
4
5
6
7
8
9

@prefix dct: <http://purl.org/dc/terms/> .

# ❌ Redundancia territorial
dct:spatial <http://datos.gob.es/recurso/sector-publico/territorio/Autonomia/Comunidad-Madrid> ;
dct:spatial <http://datos.gob.es/recurso/sector-publico/territorio/Provincia/Madrid> .

# ❌ Uso innecesario del ámbito nacional
dct:spatial <http://datos.gob.es/recurso/sector-publico/territorio/Pais/España> ;
dct:spatial <http://datos.gob.es/recurso/sector-publico/territorio/Autonomia/Andalucia> .

Referencias espaciales geométricas (dct:spatial con geometrías)#

Para describir la cobertura geométrica de los datasets de forma interoperable se pueden utilizar diferentes propiedades y formatos estándar, en particular se recomienda utilizar WKT (Well-Known Text) para describir la cobertura geométrica.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

@prefix dcat: <http://www.w3.org/ns/dcat#> .
@prefix dct: <http://purl.org/dc/terms/> .
@prefix locn: <http://www.w3.org/ns/locn#> .
@prefix geo: <http://www.opengis.net/ont/geosparql#> .

<http://datos.example.org/dataset/123> dct:spatial [
    a dct:Location ;
    locn:geometry """POLYGON((2.937889 39.608571, 4.592285 39.608571, 
            4.592285 40.573115, 2.937889 40.573115, 2.937889 39.608571))"""^^geo:wktLiteral ;
    dcat:bbox """POLYGON((2.937889 39.608571, 4.592285 39.608571, 
            4.592285 40.573115, 2.937889 40.573115, 2.937889 39.608571))"""^^geo:wktLiteral ;
    dcat:centroid "POINT(3.765087 40.090843)"^^geo:wktLiteral
  ] .

Punto de contacto (dcat:contactPoint)#

Para facilitar la comunicación con los responsables de los datasets, se debe proporcionar información de contacto estructurada utilizando la ontología vCard para la descripción de personas y organizaciones y no referir directamente a IRIs de la taxonomía como por ejemplo: (dcat:contactPoint <http://datos.gob.es/recurso/sector-publico/org/Organismo/A00000000>)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

@prefix dcat: <http://www.w3.org/ns/dcat#> .
@prefix vcard: <http://www.w3.org/206/vcard/ns#> .

<http://datos.example.org/dataset/123>
    dcat:contactPoint [
        a vcard:Kind ;
        vcard:fn "Oficina de Datos Abiertos"@es ;
        vcard:hasUid "EA0000000" ;
        vcard:hasEmail <mailto:datos@example.org> ;
        vcard:hasTelephone <tel:+34-912345678> ;
        vcard:hasURL <https://example.org/contacto> 
    ] .

1
2
3
4
5

@prefix dcat: <http://www.w3.org/ns/dcat#> .
@prefix vcard: <http://www.w3.org/206/vcard/ns#> .

<http://datos.example.org/dataset/123>
    dcat:contactPoint <http://datos.gob.es/recurso/sector-publico/org/Organismo/EA0000000> .

Convenciones para dcat:Distribution#

Modelado de URLs de acceso en servicios OGC#

Para asegurar un acceso correcto a los servicios OGC y cumplir con los requisitos de INSPIRE, es importante modelar adecuadamente las URLs de acceso a los servicios, tanto si se modelan como dcat:Distribution (desaconsejado) como si se modelan como dcat:DataService (recomendado).

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

@prefix dcat: <http://www.w3.org/ns/dcat#> .
@prefix dct: <http://purl.org/dc/terms/> .
@prefix dcatap: <http://data.europa.eu/r5r/> .
@prefix foaf: <http://xmlns.com/foaf/0.1/> .
@prefix vcard: <http://www.w3.org/206/vcard/ns#> .

# ✅ Ejemplo para metadatos usando DataService (recomendado)
<http://example.org/dataset/1> a dcat:Dataset ;
    dct:title "Dataset de ejemplo"@es ;
    dct:description "Descripción del dataset de ejemplo"@es ;
    dct:identifier "dataset-1" ;
    dcat:theme <http://datos.gob.es/kos/sector-publico/sector/medio-ambiente> ;
    dct:publisher <http://datos.gob.es/recurso/sector-publico/org/Organismo/EA0000000> ;
    dcat:accessService [ 
        a dcat:DataService ;
        dct:title "Servicio WMS de ejemplo"@es ;
        dct:description "Servicio WMS para acceder a los datos"@es ;
        dcat:theme <http://datos.gob.es/kos/sector-publico/sector/medio-ambiente> ;
        dct:publisher <http://datos.gob.es/recurso/sector-publico/org/Organismo/EA0000000> ;
        dcat:endpointURL <http://example.org/geoserver/wms> ;
        dcat:endpointDescription <http://example.org/geoserver/wms?request=GetCapabilities> ;
        dct:conformsTo <http://www.opengis.net/def/serviceType/ogc/wms> ;
        dcat:contactPoint [
            a vcard:Kind ;
            vcard:fn "Centro de soporte de Organismo"@es ;
            vcard:hasEmail <mailto:info-contacto@dcat-ap-es.ejemplo.org> ;
            vcard:hasURL <https://dcat-ap-es.ejemplo.org/formulario-soporte>
        ] ;
        dcatap:applicableLegislation <http://data.europa.eu/eli/reg_impl/2023/138/oj> ;
        dcatap:hvdCategory <http://data.europa.eu/bna/c_dd313021> ;
        foaf:page <http://example.org/services> ;
        dct:accessRights <http://publications.europa.eu/resource/authority/access-right/PUBLIC> ;
        dcat:servesDataset <http://example.org/dataset/1> 
    ] .

# ⚠️ Ejemplo para metadatos usando Distribution (no recomendado)
<http://example.org/dataset/2> a dcat:Dataset ;
    dct:title "Dataset de ejemplo 2"@es ;
    dct:description "Descripción del dataset de ejemplo 2"@es ;
    dct:identifier "dataset-2" ;
    dcat:theme <http://datos.gob.es/kos/sector-publico/sector/medio-ambiente> ;
    dct:publisher <http://datos.gob.es/recurso/sector-publico/org/Organismo/EA0000000> ;
    dcat:distribution [
        a dcat:Distribution ;
        dct:title "Distribución WMS de ejemplo"@es ;
        dct:description "Distribución WMS para acceder a los datos"@es ;
        dct:conformsTo <http://www.opengeospatial.org/standards/wms> ;
        dcat:accessURL <http://example.org/wms?request=GetCapabilities&service=WMS> ;
        dcatap:applicableLegislation <http://data.europa.eu/eli/reg_impl/2023/138/oj> ;
        dcat:spatialResolutionInMeters 5.0 ;
        dct:format <http://publications.europa.eu/resource/authority/file-type/WMS_SRVC> ;
        dct:license <http://publications.europa.eu/resource/authority/licence/CC_BY_4_0> ;
        dcatap:availability <http://publications.europa.eu/resource/authority/planned-availability/STABLE> 
    ] .

Anexo 1. Tabla de mapeo de sectores primarios a Temáticas de datos DCAT-AP#

Anexo 2. Tabla de mapeo entre Temas INSPIRE y Temáticas DCAT-AP#

Anexo 3. Mapeo de identificadores organizativos#

Este anexo proporciona guías para el mapeo entre diferentes sistemas de identificación de organismos, ver convención. En el ecosistema de datos abiertos español coexisten diferentes sistemas de identificación de organismos:

1. Códigos DIR3 (oficiales)
2. NIF (identificación fiscal)
3. Códigos internos de ministerios y organismos
4. Identificadores históricos heredados

Esto puede generar inconsistencias al:

• Relacionar datasets entre diferentes catálogos
• Vincular organizaciones publicadoras y creadoras
• Mantener la trazabilidad histórica de los datos

Tabla de equivalencias

Anexo 4. Espacios de nombres utilizados en el documento#

Este anexo proporciona una referencia completa de los espacios de nombres (namespaces) utilizados en el perfil DCAT-AP-ES y en los ejemplos de este documento. Los espacios de nombres son fundamentales para:

1. Identificar unívocamente los elementos y propiedades utilizados
2. Evitar conflictos entre vocabularios diferentes
3. Facilitar la validación y procesamiento del RDF

Ejemplo de declaración de namespaces

1
2
3
4
5
6
7
8
9

<?xml version="1.0" encoding="UTF-8"?>
<rdf:RDF 
    xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
    xmlns:dcat="http://www.w3.org/ns/dcat#"
    xmlns:dcatap="http://data.europa.eu/r5r/"
    xmlns:dct="http://purl.org/dc/terms/"
    xmlns:foaf="http://xmlns.com/foaf/0.1/"
    >
</rdf:RDF>

1
2
3
4
5

@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix dcat: <http://www.w3.org/ns/dcat#> .
@prefix dcatap: <http://data.europa.eu/r5r/> .
@prefix dct: <http://purl.org/dc/terms/> .
@prefix foaf: <http://xmlns.com/foaf/0.1/> .

Los prefijos listados son los más comúnmente utilizados, aunque técnicamente se podrían usar otros siempre que se declaren correctamente.