OGC API – Features

Descripción General

Los estándares de API de OGC definen bloques de construcción de API modulares para habilitar API web de manera espacial y consistente. La especificación OpenAPI se utiliza para definir los bloques de construcción de API.

La familia de estándares de API de OGC está organizada por tipo de recurso. Este estándar especifica los componentes básicos de API fundamentales para interactuar con las características. La comunidad de datos espaciales utiliza el término "característica" para referirse a elementos del mundo real que son de interés.

Para aquellos que no están familiarizados con el término "característica", las explicaciones sobre Cosas Espaciales, Características y Geometría en el documento Mejores Prácticas de Datos Espaciales en la Web del W3C/OGC brindan más detalles.

OGC API Features proporciona bloques de construcción de API para crear, modificar y consultar características en la Web. OGC API Features consta de varias partes, cada una de las cuales es un estándar independiente. La Parte 1, el "Núcleo", especifica las capacidades principales y se limita a obtener características donde las geometrías están representadas en el sistema de referencia de coordenadas WGS 84 con orden de eje de longitud/latitud. La Parte 2 especifica las capacidades para obtener características que tienen geometrías representadas en todos los demás sistemas de referencia de coordenadas. Las capacidades adicionales que abordan necesidades más avanzadas se especificarán en partes adicionales. Los ejemplos incluyen soporte para crear y modificar características, modelos de datos más complejos, consultas más completas, conjuntos de datos múltiples y jerarquías de recopilación.

La Parte 1 de esta norma está disponible de forma gratuita en este sitio web de OGC. El documento también ha sido publicado por la Organización Internacional de Normalización (ISO) como Norma ISO 19168-1: 2020.

De manera predeterminada, cada API que implemente este estándar brindará acceso a un único conjunto de datos. En lugar de compartir los datos como un conjunto de datos completo, los estándares de características de la API de OGC ofrecen acceso directo y detallado a los datos a nivel de característica (objeto).

Los bloques de construcción de API especificados en este estándar son coherentes con la arquitectura de la Web. En particular, el diseño de API está guiado por las RFC HTTP/HTTPS de IETF, las Mejores Prácticas de Datos en la Web del W3C, las Mejores Prácticas de Datos Espaciales en la Web del W3C/OGC y las Directrices de API Web emergentes de OGC. Un ejemplo particular es el uso de los conceptos de conjuntos de datos y distribuciones de conjuntos de datos tal como se definen en DCAT y se utilizan en schema.org.

Esta norma especifica las operaciones de descubrimiento y consulta que se implementan mediante el método HTTP GET. La compatibilidad con métodos adicionales (en particular POST, PUT, DELETE, PATCH) se especificará en partes adicionales.

Las operaciones de descubrimiento permiten a los clientes interrogar a la API para determinar sus capacidades y recuperar información sobre esta distribución del conjunto de datos, incluida la definición de la API y los metadatos sobre las colecciones de características proporcionadas por la API.

Las operaciones de consulta permiten a los clientes recuperar características del almacén de datos subyacente basándose en criterios de selección simples, definidos por el cliente.

Se pueden encontrar recursos adicionales, como documentos de definición de OpenAPI, en API de OGC sitio web.