17 jul 2023

Nuevos servicios de procesos (OGC API-Processes)

El O.A. Centro Nacional de Información Geográfica (CNIG) acaba de publicar nuevos servicios de procesos del Sistema Cartográfico Nacional de España (SCNE) a través de un servicio web, utilizando el nuevo estándar OGC API - Processes.

·                API de procesos (API- Processes) del SCNE: https://api-processes.idee.es/


El servicio está basado en el estándar OGC API-Processes que define las operaciones y procesos necesarios para ejecutar funciones y algoritmos que utilizan información geoespacial desde un servidor. Estos algoritmos utilizan datos geoespaciales, para producir nuevos conjuntos de datos. El estándar no define cómo son estos algoritmos sino la interfaz para su ejecución. Algunos ejemplos de algoritmos son los que realizan cálculo de elevaciones, transformación de coordenadas y áreas de influencia.

La OGC API-Processes es una versión más nueva y moderna del estándar de OGC para Servicios Web de Procesamiento (WPS). Como en otros estándares de OGC API, la novedad es que se cuenta con una interfaz autodescriptiva, mucho más intuitiva y amigable que el anterior GetCapabilities. En cuanto a la funcionalidad, la OGC API-Processes aborda todos los casos de uso que el WPS y además proporciona capacidades y funcionalidades adicionales. Utiliza un enfoque diferente para programar e interactuar con recursos en la web. Específicamente, aprovecha la especificación OpenAPI y un enfoque orientado a los recursos, lo que permite una mejor integración en los paquetes de software existentes. El estándar especifica una interfaz de procesado para comunicarse a través de un protocolo RESTful utilizando codificaciones de notación de objetos JavaScript (JSON).

El CNIG, para la publicación de esos servicios, ha optado por el programa pygeoapi, de fuente abierta, y con licencia MIT. La documentación se ofrece en formato Swagger UI, que permite al usuario probar las consultas y realizar test previos a la configuración, ReDoc, y Documento OpenAPI.

Las OGC API - Processes se unen a las OGC API - Features y OGC API - Maps, ya publicadas hace unas semanas, en un esfuerzo por modernizar los estándares y servicios de acceso a los datos geoespaciales.

Algunos ejemplos de uso

  1. /processes
Devuelve el listado de los procesos disponibles

https://api-processes.idee.es/processes?f=json
   
  1. /processes/{process-id}
Devuelve una descripción detallada del proceso y sus parámetros.

https://api-processes.idee.es/processes/getElevation?f=json       

  1. /jobs//
Permite la gestión y el seguimiento de las tareas activas. Esta sección se utiliza para recuperar los resultados, eliminar tareas atascadas y otro tipo de gestiones relacionadas con el estado de las tareas.



¿Cómo consultar datos?

Las OGC API - Processes son un poco más complicadas que otros estándares OGC API, ya que la obtención de datos se realiza mediante una solicitud HTTP POST en lugar de una consulta. Hay muchas formas de hacerlo. Por ejemplo, puede usar el comando cURL, una biblioteca de Python o el mismo Swagger UI.

La API CNIG permite realizar este tipo de peticiones. En la galería de ejemplos, puedes encontrar dos ejemplos:

Enlaces para saber más

Procesos publicados

A continuación, se listan los procesos publicados en esta primera versión.

Estadísticas simplificadas de altitud

Obtiene la elevación máxima, mínima, la media y la desviación típica para un polígono a partir del MDT05.

Altitud de puntos

Obtiene la elevación de uno o varios puntos a partir del MDT05.

Área de influencia con estadísticas de altitud

Obtiene un área de influencia, creada con un punto y distancia dados. Opcionalmente devuelve como atributos la elevación máxima, mínima, la media y la desviación típica para un a partir del MDT05.

Perfil de elevación

Obtiene el perfil de elevaciones entre dos o más puntos. Para la obtención de este perfil se crean puntos intermedios. Estos puntos se crean según el parámetro distancia. Se calcula a partir del MDT05.

Transformador de coordenadas

Obtiene las coordenadas transformadas de un punto de un sistema de referencia a otro basado en la especificación de OGC Web Transformation Coordinate Service (WCTS). Este proceso permite la utilización de cualquier datum.

Conversor de unidades

Convierte de grados decimales a grados, minutos y segundos y viceversa.

Transformador de coordenadas a partir de un fichero GML (url o texto)

Obtiene las coordenadas transformadas de un fichero GML (url o texto) de un sistema de referencia a otro basado en la especificación de OGC Web Transformation Coordinate Service (WCTS). Este proceso permite la utilización de cualquier datum.


Publicado por Aurelio Aragón Velasco y Cecilia Poyatos Hernández.

No hay comentarios: