OGC API – Features

Gli standard API OGC definiscono blocchi di costruzione API modulari per abilitare spazialmente le API Web in modo coerente. La specifica OpenAPI viene utilizzata per definire i blocchi di costruzione API.

La famiglia di standard API OGC è organizzata per tipo di risorsa. Questo standard specifica i blocchi fondamentali dell'API per interagire con le feature. La comunità dei dati spaziali usa il termine "feature" per le cose del mondo reale che sono di interesse.

Per chi non ha familiarità con il termine "caratteristica", le spiegazioni su Spatial Things, Features e Geometry nel documento W3C/OGC Spatial Data on the Web Best Practice forniscono maggiori dettagli.

OGC API Features fornisce componenti API per creare, modificare e interrogare feature sul Web. OGC API Features è composto da più parti, ciascuna delle quali rappresenta uno standard separato. La Parte 1, "Core", specifica le funzionalità principali ed è limitata al recupero di feature le cui geometrie sono rappresentate nel sistema di riferimento delle coordinate WGS 84 con ordine degli assi longitudine/latitudine. La Parte 2 specifica le funzionalità per il recupero di feature le cui geometrie sono rappresentate in tutti gli altri sistemi di riferimento delle coordinate. Ulteriori funzionalità che soddisfano esigenze più avanzate saranno specificate in parti aggiuntive. Tra gli esempi figurano il supporto per la creazione e la modifica di feature, modelli di dati più complessi, query più complete, dataset multipli e gerarchie di raccolta.

La Parte 1 di questa norma è disponibile gratuitamente sul sito web dell'OGC. Il documento è stato inoltre pubblicato dall'Organizzazione internazionale per la standardizzazione (ISO) con la sigla ISO 19168-1:2020.

Per impostazione predefinita, ogni API che implementa questo standard fornirà l'accesso a un singolo set di dati. Invece di condividere i dati come un set di dati completo, gli standard OGC API Features offrono un accesso diretto e dettagliato ai dati a livello di feature (oggetto).

I blocchi di costruzione API specificati in questo standard sono coerenti con l'architettura del Web. In particolare, la progettazione API è guidata dagli IETF HTTP/HTTPS RFC, dalle W3C Data on the Web Best Practices, dalle W3C/OGC Spatial Data on the Web Best Practices e dalle emergenti OGC Web API Guidelines. Un esempio particolare è l'uso dei concetti di dataset e distribuzioni di dataset come definiti in DCAT e utilizzati in schema.org.

Questo standard specifica le operazioni di scoperta e query che vengono implementate utilizzando il metodo HTTP GET. Il supporto per metodi aggiuntivi (in particolare POST, PUT, DELETE, PATCH) verrà specificato in parti aggiuntive.

Le operazioni di individuazione consentono ai client di interrogare l'API per determinarne le capacità e recuperare informazioni su questa distribuzione del set di dati, tra cui la definizione dell'API e i metadati sulle raccolte di funzionalità fornite dall'API.

Le operazioni di query consentono ai client di recuperare funzionalità dall'archivio dati sottostante in base a semplici criteri di selezione definiti dal client.