OGC API – Features

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.

Las Características de la API de OGC proporcionan componentes básicos de la API para crear, modificar y consultar características en la Web. Constan de varias partes, cada una de las cuales constituye un estándar independiente. La Parte 1, "Núcleo", especifica las capacidades principales y se limita a la obtención de características cuyas geometrías se representan en el sistema de referencia de coordenadas WGS 84 con orden de ejes de longitud/latitud. La Parte 2 especifica las capacidades para obtener características cuyas geometrías se representan en todos los demás sistemas de referencia de coordenadas. En secciones posteriores se especificarán capacidades adicionales que abordan necesidades más avanzadas. Por ejemplo, la compatibilidad con la creación y modificación de características, modelos de datos más complejos, consultas más completas, conjuntos de datos múltiples y jerarquías de colecciones.

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.