OGC API – Features

Os padrões OGC API definem blocos de construção de API modulares para habilitar espacialmente Web APIs de forma consistente. A especificação OpenAPI é usada para definir os blocos de construção de API.

A família de padrões OGC API é organizada por tipo de recurso. Este padrão especifica os blocos de construção fundamentais da API para interagir com recursos. A comunidade de dados espaciais usa o termo "recurso" para coisas no mundo real que são de interesse.

Para aqueles que não estão familiarizados com o termo "recurso", as explicações sobre Coisas Espaciais, Recursos e Geometria no documento Melhores Práticas de Dados Espaciais na Web do W3C/OGC fornecem mais detalhes.

O OGC API Features fornece blocos de construção de API para criar, modificar e consultar recursos na Web. O OGC API Features é composto por várias partes, cada uma delas um padrão separado. A Parte 1, o "Núcleo", especifica as capacidades principais e se restringe à recuperação de recursos cujas geometrias são representadas no sistema de referência de coordenadas WGS 84 com ordem de eixo longitude/latitude. A Parte 2 especifica as capacidades para recuperar recursos cujas geometrias são representadas em todos os outros sistemas de referência de coordenadas. Capacidades adicionais que atendem a necessidades mais avançadas serão especificadas em partes adicionais. Exemplos incluem suporte para criação e modificação de recursos, modelos de dados mais complexos, consultas mais ricas, múltiplos conjuntos de dados e hierarquias de coleções.

A Parte 1 desta norma está disponível gratuitamente neste site da OGC. O documento também foi publicado pela Organização Internacional de Normalização (ISO) como ISO 19168-1: 2020.

Por padrão, cada API que implementa esse padrão fornecerá acesso a um único conjunto de dados. Em vez de compartilhar os dados como um conjunto de dados completo, os padrões OGC API Features oferecem acesso direto e refinado aos dados no nível do recurso (objeto).

Os blocos de construção da API especificados neste padrão são consistentes com a arquitetura da Web. Em particular, o design da API é guiado pelos RFCs HTTP/HTTPS do IETF, as Melhores Práticas de Dados na Web do W3C, as Melhores Práticas de Dados Espaciais na Web do W3C/OGC e as Diretrizes emergentes da API da Web do OGC. Um exemplo específico é o uso dos conceitos de conjuntos de dados e distribuições de conjuntos de dados conforme definido no DCAT e usado no schema.org.

Este padrão especifica operações de descoberta e consulta que são implementadas usando o método HTTP GET. O suporte para métodos adicionais (em particular POST, PUT, DELETE, PATCH) será especificado em partes adicionais.

As operações de descoberta permitem que os clientes interroguem a API para determinar seus recursos e recuperar informações sobre essa distribuição do conjunto de dados, incluindo a definição da API e metadados sobre as coleções de recursos fornecidas pela API.

As operações de consulta permitem que os clientes recuperem recursos do armazenamento de dados subjacente com base em critérios de seleção simples, definidos pelo cliente.