Nuevos servicios de descarga de objetos geográficos (OGC API - Features)

El O.A. Centro Nacional de Información Geográfica (CNIG) acaba de publicar los conjuntos de datos del Sistema Cartográfico Nacional de España (SCNE) y del Instituto Geográfico Nacional (IGN) a través de dos servicios web, utilizando el nuevo estándar OGC API - Features.

Estos dos servicios proporcionan los mismos datos que los Web Feature Services (WFS), pero de una forma más accesible: el uso de la OGC API es más fácil y la explotación de los datos vectoriales es más amigable.

• API de descarga de objetos geográficos (API-Features) del SCNE: https://api-features.idee.es/
• API de descarga de objetos geográficos (API-Features) del IGN: https://api-features.ign.es/

Una de las novedades con respecto a los WFS es que tienen página de inicio en la que se muestra información y desde la que se accede a las colecciones del servicio. Al entrar en cada una de ellas se pueden examinar intuitivamente las features (objetos geográficos), ya que incorpora un visualizador en el que se van representando los objetos geográficos a la vez que se muestra su información alfanumérica. La principal ventaja, común a todos los servicios de descarga, es que las aplicaciones pueden mostrar las entidades vectoriales o procesarlas como parte de un flujo de trabajo y utilizarlas desde el lado del cliente.

Esas features (objetos geográficos) se pueden utilizar directamente desde multitud de clientes: programas de escritorio SIG (QGIS, FME, ArcGIS Pro…) y librerías como GDAL y otras API (OpenLayers, Leaflet…). Las implementaciones y casos de uso de estos nuevos estándares aumentan significativamente conforme más organismos publican sus datos en OGC API - Features. Por ejemplo, en las próximas versiones de la API CNIG se podrá consultar este tipo de servicios desde el plugin fulltoc. La lista actualizada de implementaciones de cliente se puede consultar en el GitHub de ogcapi-features.

Para utilizarlo en QGIS simplemente se debe cargar la capa desde el menú Capa / Añadir Capa/ WFS – OGC API - Features

El CNIG, para la publicación de esos servicios, ha optado por el programa pygeoapi, de fuente abierta, y con licencia MIT.

Con esta publicación y los servicios que vendrán después: Maps, Tiles, Coverages, Processes, el CNIG, junto con los servicios que publica, se adapta a los nuevos estándares, dando un paso adelante en interoperabilidad y usabilidad de la información geográfica. Se moderniza el acceso a los datos de alto valor que se publican, abriendo nuevas posibilidades de explotación y de nuevas aplicaciones.

OGC API - Features

El estándar OGC API - Features es el primero de los estándares aprobados dentro de la nueva familia de OGC API. Todos los nuevos estándares tienen en común que están basados en OpenAPI, las respuestas son JSON y HTML preferentemente y están ideados de manera modular a partir de bloques.

La familia de estándares API de OGC está organizada por tipo de recurso y OGC API - Features está ideada especialmente para publicar y descargar información vectorial.

La parte principal del estándar se llama OGC API - Features - Parte 1: Núcleo, describe las capacidades obligatorias que debe admitir cada servicio de implementación y está restringida al acceso de lectura de datos espaciales. Por lo tanto, especifica las operaciones de descubrimiento y consulta que se implementan mediante el método HTTP GET.

Las funcionalidades adicionales (en particular, los métodos POST, PUT, DELETE y PATCH), que abordan necesidades concretas, se especificarán en partes posteriores del estándar. Esas partes también incluirán soporte para crear y modificar datos, consultas y modelos de datos más complejos y sistemas de referencia de coordenadas adicionales.

En la Parte 1 (Núcleo) que se ha implementado, el sistema de referencia de coordenadas espaciales (CRS) predeterminado es WGS 84 de longitud/latitud con o sin altura.

Algunos ejemplos de uso

A continuación, se muestran tres casos de usos de consulta de features (entidades geográficas):

1. /collections

Enumera las colecciones de datos en el servidor que se pueden consultar, y cada una describe información básica sobre la colección de datos geoespaciales, como su identificación y descripción, así como la extensión espacial y temporal de todos los datos contenidos.

Por ejemplo: https://api-features.idee.es/collections?f=json

2. /collections/{collectionId}/items?bbox=minlon,minlat,maxlon,maxlat

Solicita todos los datos de una colección para una zona determinada. Los datos se devuelven en fragmentos paginados, y cada respuesta contiene un enlace a la siguiente, ya que muchas colecciones son bastante grandes. La especificación central admite algunos filtros básicos, además del filtro BBOX anterior, con extensiones que brindan opciones más avanzadas.

Por ejemplo:

• {collectionId} - transportes/AerodromeArea
• longitud mínima: -3.7
• latitud mínima: 40.5
• latitud máxima: -3.4
• longitud máxima: 40.7

https://api-features.idee.es/collections/aerodromearea/items?bbox=-3.7,40.5,-3.4,40.7

3. /collections/{collectionId}/items/{featureId}

Devuelve una sola feature, algo en el mundo real (un edificio, un río, un municipio, etc.) que normalmente se describe mediante una geometría junto con el resto de las propiedades. Esto proporciona una URL canónica y estable para acceder a cada «item» concreto.

Por ejemplo:

• {collectionId} - hidrografia/Wetland
• {featureId} - ES040HYWLDS000000155399

https://api-features.idee.es/collections/wetland/items/ES040HYWLDS0000001553993

Relación OGC API - Features con OGC WFS

El cambio sustancial del estándar es que se moderniza la manera de acceder a cada entidad, simplificando, respecto al WFS, los parámetros obligatorios necesarios para obtener una entidad.

El estándar OGC Web Feature Service (WFS) sigue siendo más apropiado cuando se trabaja con aplicaciones cliente que solo admiten los servicios web OGC clásicos. Los WFS implementan el lenguaje de marcado geográfico (GML) como formato de datos predeterminado, lo que puede resultar poco práctico para algunas aplicaciones, que prefieren GeoJSON.

Sin embargo, OGC API - Features recomienda utilizar HTML y GeoJSON como codificaciones, que son formatos más ligeros, sencillos y modernos. Mucho más adaptados a las nuevas tendencias para Internet y de uso más accesible y fácil para personas desarrolladoras.

Ventajas para personas desarrolladoras

La verdadera apuesta en los nuevos estándares OGC API es mejorar el modo de acceso y consulta a las colecciones para recuperar las entidades, en definitiva, resultar amigable a las personas que desarrollan estén o no familiarizadas con la información geoespacial.

Desde las páginas de inicio, se puede ir navegando intuitivamente por las diferentes colecciones y descubrir las features disponibles en cada una. Esta navegación por URL permite que se puedan realizar consultas y recuperar entidades de una manera muy sencilla que se puede utilizar en aplicaciones de todo tipo. El servicio es autodescriptivo y las opciones de descubrimiento son implícitas en la declaración del estándar. Por ejemplo, en la sección de consultas (queryables) se describen los atributos consultables.

Además se ofrece la documentación en formato Swagger UI, que permite al usuario probar las consultas y realizar test previos a la configuración, ReDoc, y Documento OpenAPI.

Enlaces para saber más

• OGC API - Features página principal.
• OGC API - Features - Parte 1: Core corrigendum.
• OGC API - Features Repositorio GitHub.
• OGC API – Features Documentación.
• Otras OGC API en la IDEE  Listado de implementaciones de OGC API en la IDEE.
• Entrada blog IDEE de la publicación OGC API - Features IDEC.

Colecciones publicadas

A continuación, se relacionan las colecciones publicadas en esta primera versión.

https://api-features.idee.es/

Nombre	Descripción
Cruces	Objeto artificial que permite el paso del agua por encima o por debajo de un obstáculo. Puede ser de tipo acueducto, puente, alcantarilla o sifón.
Presas o represas	Barrera permanente a través de un curso de agua, utilizada para almacenar agua o controlar su flujo.
Cuencas de captación	Zona que tiene un desagüe común para su escorrentía.
Cascadas	Parte de un curso de agua que desciende verticalmente al caer desde una altura.
Vados	Parte poco profunda de un curso de agua utilizada para atravesarlo.
Línea de costa	Línea de costa correspondiente a la cota cero del Instituto Geográfico Nacional. Referencia de Altimetría.
Esclusas	Recinto con un par o una serie de puertas utilizado para hacer subir o bajar a los buques que pasan de un nivel de agua a otro.
Cuencas hidrográficas	Territorio cuya escorrentía superficial fluye en su totalidad hacia el mar, a través de una serie de corrientes, ríos y, posiblemente, lagos, en una sola desembocadura, sea estuario o delta.
Construcciones litorales	Estructura artificial unida a terrenos que bordean una masa de agua y cuya posición es fija.
Aguas estancadas	Masa de agua que está rodeada por completo de tierra.
Cursos de agua	Corriente de agua natural o artificial.
Humedales	Zona poco drenada o inundada periódicamente cuyo suelo se encuentra saturado de agua y admite vegetación.
Nodos hidrográficos	Nodo dentro de la red hidrográfica.
Enlaces de curso de agua	Segmento de un curso de agua dentro de una red hidrográfica.
Secuencia de enlaces de curso de agua	Secuencia de enlaces de curso de agua que representa una trayectoria sin ramificación a través de una red hidrográfica.
Área de aeródromo	Zona definida, sobre tierra o agua (incluidos eventuales edificios, instalaciones y equipos), cuyo propósito es ser utilizada total o parcialmente para la llegada, salida y movimiento en superficie de aeronaves y/o helicópteros.
Nodo de aeródromo	Nodo localizado en el punto de referencia del aeródromo de un aeropuerto/helipuerto, que se utiliza para representarlo de manera simplificada.
Área de plataforma	Área definida, en un aeródromo/helipuerto terrestre, destinada a dar cabida a las aeronaves/helicópteros para los fines de embarque o desembarque de pasajeros, correo o carga, abastecimiento de combustible, estacionamiento o mantenimiento.
Área de pista	Área rectangular definida en un aeródromo/helipuerto terrestre preparada para el aterrizaje y el despegue de aeronaves.
Área de calle de rodaje	Vía definida en un aeródromo/helipuerto, establecida para el rodaje de aeronaves/helicópteros y destinada a proporcionar enlace entre dos partes del aeródromo.
Enlace de cable transportador	Objeto espacial lineal que describe la geometría y la conectividad de una red de cable entre dos puntos de una red de transporte por cable.
Nodo de cable transportador	Objeto espacial puntual que se utiliza para representar la conectividad entre dos enlaces de cable transportador consecutivos.
Enlace ferroviario	Objeto espacial lineal que describe la geometría y la conectividad de una red ferroviaria entre dos puntos de la red.
Nodo ferroviario	Objeto espacial puntual que representa un punto significativo a lo largo de la red ferroviaria o define una intersección de vías férreas, utilizado para describir su conectividad.
Área de estación ferroviaria	Objeto espacial superficial que se usa para representar los límites topográficos de las instalaciones de una estación ferroviaria (edificios, zonas de operaciones, centros y equipos) dedicadas a la ejecución de las actividades de la estación ferroviaria.
Nodo de estación ferroviaria	Nodo ferroviario que representa la localización de una estación ferroviaria a lo largo de la red ferroviaria.
Enlace de carretera	Objeto espacial lineal que describe la geometría y la conectividad de una red viaria entre dos puntos de la red. Un enlace de carretera puede representar caminos, pistas para bicicletas, carreteras de calzada única, carreteras de calzada múltiple.
Nodo de carretera	Objeto espacial puntual que se utiliza para representar la conectividad entre dos enlaces de carretera o para representar un objeto espacial significativo, tal como una estación de servicio o una rotonda.
Área de servicio de carretera	Superficie aneja a una carretera y dedicada a ofrecer determinados servicios en relación con ella.
Área portuaria	Objeto espacial superficial que se usa para representar los límites físicos de todas las instalaciones que constituyen la zona terrestre de un puerto marítimo o interior.
Nodo portuario	Objeto espacial puntual que se usa para representar un puerto marítimo o interior de manera simplificada, localizado aproximadamente a orillas de la masa de agua en la que se sitúa el puerto.
Enlace de vía navegable	Objeto espacial lineal que describe la geometría o la conectividad de la red de transporte por vía navegable entre dos nodos de vía o curso navegable consecutivos. Representa una sección lineal a través de una masa de agua que se utiliza para la navegación.
Nodo de vía navegable	Objeto espacial puntual que se utiliza para representar la conectividad entre dos enlaces de vía navegable diferentes, o entre un enlace de vía navegable y un enlace de curso navegable, en la red de transporte por vía navegable.
Hito	Indicador que se coloca a lo largo de una ruta en una red de transporte, habitualmente a intervalos regulares, para indicar la distancia desde el principio de la ruta, o desde algún otro punto de referencia, al punto en que está ubicado el hito.
Dirección	Una identificación de la localización fija de una propiedad por medio de una composición estructurada de nombres geográficos e identificadores.
Usos del suelo	Unidades del Sistema de Información sobre Ocupación del Suelo de España (año 2014).

https://api-features.ign.es/

Nombre	Descripción
Unidades administrativas	Unidad de administración sobre la que un Estado miembro tiene y/o ejerce derechos jurisdiccionales para el gobierno local, regional y nacional.
Límites administrativos	Línea de demarcación entre unidades administrativas.
Nombres geográficos	Representación de nombres geográficos como los nombres de zonas, regiones, localidades, ciudades, periferias, poblaciones o asentamientos, o cualquier rasgo geográfico o topográfico de interés público o histórico procedentes del Nomenclátor Geográfico...
Red de Estaciones de Referencia GNSS (ERGNSS)	Contiene la información relativa a la Red de Estaciones de Referencia GNSS (código, nombre y reseña).
Red de Nivelación de Alta Precisión (REDNAP)	Contiene la información relativa a la Red Española de Nivelación de Alta Precisión (número, nombre, reseña, nodo, tipo, grupo, línea y reseña de la línea).
Red REGENTE	Contiene la información relativa a la Red Geodésica Nacional por Técnicas Espaciales (número, nombre, reseña, hoja, municipio y provincia).
Red de Orden Inferior (ROI)	Contiene la información relativa a la Red de Orden Inferior (número, nombre, reseña, hoja, municipio y provincia).

Publicado por Gloria Andrés Yusá y Cecilia Poyatos Hernández.