Les normes API OGC définissent des blocs de construction d'API modulaires pour activer spatialement les API Web de manière cohérente. La spécification OpenAPI est utilisée pour définir les blocs de construction d'API.
La famille de normes API de l'OGC est organisée par type de ressource. Cette norme spécifie les éléments fondamentaux de l'API pour interagir avec les entités. La communauté des données spatiales utilise le terme « entité » pour les éléments du monde réel qui présentent un intérêt.
Pour ceux qui ne connaissent pas le terme « fonctionnalité », les explications sur les objets spatiaux, les fonctionnalités et la géométrie dans le document W3C/OGC Spatial Data on the Web Best Practice fournissent plus de détails.
L'API OGC fournit des composants permettant de créer, modifier et interroger des entités sur le Web. Elle se compose de plusieurs parties, chacune constituant une norme distincte. La partie 1, le « Noyau », spécifie les fonctionnalités de base et se limite à l'extraction d'entités dont la géométrie est représentée dans le système de référence de coordonnées WGS 84, avec l'ordre des axes longitude/latitude. La partie 2 spécifie les fonctionnalités permettant d'extraire des entités dont la géométrie est représentée dans tous les autres systèmes de référence de coordonnées. Des fonctionnalités supplémentaires, répondant à des besoins plus avancés, seront spécifiées dans des parties ultérieures. On peut citer, par exemple, la prise en charge de la création et de la modification d'entités, des modèles de données plus complexes, des requêtes plus riches, la gestion de plusieurs jeux de données et des hiérarchies de collections.
La première partie de cette norme est disponible gratuitement sur le site web de l'OGC. Ce document a également été publié par l'Organisation internationale de normalisation (ISO) sous la référence ISO 19168-1:2020.
Par défaut, chaque API implémentant cette norme fournira l'accès à un seul ensemble de données. Plutôt que de partager les données sous forme d'ensemble de données complet, les normes OGC API Features offrent un accès direct et précis aux données au niveau de la fonctionnalité (objet).
Les blocs de construction d'API spécifiés dans cette norme sont cohérents avec l'architecture du Web. En particulier, la conception de l'API est guidée par les RFC HTTP/HTTPS de l'IETF, les meilleures pratiques W3C sur les données sur le Web, les meilleures pratiques W3C/OGC sur les données spatiales sur le Web et les nouvelles directives OGC sur les API Web. Un exemple particulier est l'utilisation des concepts d'ensembles de données et de distributions d'ensembles de données tels que définis dans DCAT et utilisés dans schema.org.
Cette norme spécifie les opérations de découverte et de requête implémentées à l'aide de la méthode HTTP GET. La prise en charge de méthodes supplémentaires (notamment POST, PUT, DELETE, PATCH) sera précisée dans des parties supplémentaires.
Les opérations de découverte permettent aux clients d’interroger l’API pour déterminer ses capacités et récupérer des informations sur cette distribution de l’ensemble de données, y compris la définition de l’API et les métadonnées sur les collections de fonctionnalités fournies par l’API.
Les opérations de requête permettent aux clients de récupérer des fonctionnalités du magasin de données sous-jacent en fonction de critères de sélection simples, définis par le client.
