ISO 19168-1:2025
(Main)Geographic information — Geospatial API for features — Part 1: Core
Geographic information — Geospatial API for features — Part 1: Core
This document specifies the behaviour of Web APIs that provide access to features in a dataset independently of the underlying data store. This document defines discovery and query operations. Discovery operations enable clients to interrogate the API, including the API definition and metadata about the feature collections provided by the API, to determine the capabilities of the API and retrieve information about available distributions of the dataset. Query operations enable clients to retrieve features from the underlying data store based upon simple selection criteria, defined by the client.
Information géographique — API géospatiale pour les entités — Partie 1: Profil minimal
Le présent document spécifie le comportement des API Web donnant accès aux entités d’un jeu de données indépendamment du système sous-jacent de stockage de données. Le présent document définit les opérations de découverte et d’interrogation. Les opérations de découverte permettent aux clients d’interroger l’API, y compris la définition et les métadonnées de l’API concernant les collections d’entités fournies par l’API, pour déterminer les capacités de l’API et extraire des informations relatives aux distributions disponibles de jeux de données. Les opérations d’interrogation permettent aux clients d’extraire des entités du système sous-jacent de stockage de données sur la base de critères de sélection simples définis par le client.
General Information
Relations
Buy Standard
Standards Content (Sample)
International
Standard
ISO 19168-1
Second edition
Geographic information —
2025-01
Geospatial API for features —
Part 1:
Core
Information géographique — API géospatiale pour les entités —
Partie 1: Profil minimal
Reference number
© ISO 2025
All rights reserved. Unless otherwise specified, or required in the context of its implementation, no part of this publication may
be reproduced or utilized otherwise in any form or by any means, electronic or mechanical, including photocopying, or posting on
the internet or an intranet, without prior written permission. Permission can be requested from either ISO at the address below
or ISO’s member body in the country of the requester.
ISO copyright office
CP 401 • Ch. de Blandonnet 8
CH-1214 Vernier, Geneva
Phone: +41 22 749 01 11
Email: copyright@iso.org
Website: www.iso.org
Published in Switzerland
ii
Contents Page
Foreword .v
Introduction .vii
1 Scope . 1
2 Normative references . 1
3 Terms and definitions . 2
3.1 Terms and definitions .2
3.2 Abbreviated terms .3
4 Conformance . 3
5 Conventions . 4
5.1 Identifiers .4
5.2 Link relations .4
5.3 Use of HTTPS .5
5.4 HTTP URIs .5
5.5 API definition .5
5.5.1 General remarks .5
5.5.2 Role of OpenAPI .5
5.5.3 References to OpenAPI components in normative statements .6
5.5.4 Paths in OpenAPI definitions .6
5.5.5 Reusable OpenAPI components .6
6 Overview . 7
6.1 Design considerations .7
6.2 Encodings .7
6.3 Examples .8
7 Requirements class "Core" . 9
7.1 Overview .9
7.2 API landing page .10
7.2.1 Operation .10
7.2.2 Response . .10
7.2.3 Error situations .11
7.3 API definition .11
7.3.1 Operation .11
7.3.2 Response . . 12
7.3.3 Error situations . 12
7.4 Declaration of conformance classes . 12
7.4.1 Operation . 12
7.4.2 Response . . 13
7.4.3 Error situations . 13
7.5 HTTP 1.1 . 13
7.5.1 HTTP status codes . 13
7.6 Unknown or invalid query parameters .14
7.7 Web caching . 15
7.8 Support for cross-origin requests . 15
7.9 Encodings . 15
7.10 String internationalization .16
7.11 Coordinate reference systems .16
7.12 Link headers .17
7.13 Feature collections .17
7.13.1 Operation .17
7.13.2 Response . .17
7.13.3 Error situations . 23
7.14 Feature collection .24
7.14.1 Operation .24
iii
7.14.2 Response . .24
7.14.3 Error situations .24
7.15 Features .24
7.15.1 Operation .24
7.15.2 Parameter limit. 25
7.15.3 Parameter bbox . 26
7.15.4 Parameter datetime.27
7.15.5 Parameters for filtering on feature properties . 29
7.15.6 Combinations of filter parameters . 29
7.15.7 Response . . 30
7.15.8 Error situations .32
7.16 Feature .32
7.16.1 Operation .32
7.16.2 Response . .
...
Norme
internationale
ISO 19168-1
Deuxième édition
Information géographique — API
2025-01
géospatiale pour les entités —
Partie 1:
Profil minimal
Geographic information — Geospatial API for features —
Part 1: Core
Numéro de référence
DOCUMENT PROTÉGÉ PAR COPYRIGHT
© ISO 2025
Tous droits réservés. Sauf prescription différente ou nécessité dans le contexte de sa mise en œuvre, aucune partie de cette
publication ne peut être reproduite ni utilisée sous quelque forme que ce soit et par aucun procédé, électronique ou mécanique,
y compris la photocopie, ou la diffusion sur l’internet ou sur un intranet, sans autorisation écrite préalable. Une autorisation peut
être demandée à l’ISO à l’adresse ci-après ou au comité membre de l’ISO dans le pays du demandeur.
ISO copyright office
Case postale 401 • Ch. de Blandonnet 8
CH-1214 Vernier, Genève
Tél.: +41 22 749 01 11
E-mail: copyright@iso.org
Web: www.iso.org
Publié en Suisse
ii
Sommaire Page
Avant-propos .v
Introduction .vii
1 Domaine d’application . 1
2 Références normatives . 1
3 Termes et définitions . 2
3.1 Termes et définitions .2
3.2 Abréviations.3
4 Conformité . 3
5 Conventions . 4
5.1 Identifiants .4
5.2 Relations de lien .5
5.3 Utilisation de HTTPS .5
5.4 URI HTTP .5
5.5 Définition de l’API .6
5.5.1 Remarques générales .6
5.5.2 Rôle d’OpenAPI .6
5.5.3 Références aux composants OpenAPI dans les déclarations normatives .6
5.5.4 Chemins des définitions d’OpenAPI .7
5.5.5 Composants OpenAPI réutilisables .7
6 Vue d’ensemble . 7
6.1 Considérations relatives à la conception .7
6.2 Encodages .8
6.3 Exemples .9
7 Classe d’exigences «Profil minimal» . 9
7.1 Vue d’ensemble .9
7.2 Page de destination API .11
7.2.1 Fonctionnement .11
7.2.2 Réponse .11
7.2.3 Situations d’erreur . 12
7.3 Définition de l’API . 12
7.3.1 Fonctionnement . 12
7.3.2 Réponse . 12
7.3.3 Situations d’erreur . 13
7.4 Déclaration de classes de conformité . 13
7.4.1 Fonctionnement . 13
7.4.2 Réponse . 13
7.4.3 Situations d’erreur . 13
7.5 HTTP 1.1 .14
7.5.1 Codes de statut HTTP . .14
7.6 Paramètres d’interrogation inconnus ou non valides . 15
7.7 Mise en cache sur le Web . 15
7.8 Prise en charge des requêtes entre origines multiples .16
7.9 Encodages .16
7.10 Internationalisation des chaînes .17
7.11 Systèmes de référence par coordonnées .17
7.12 En-têtes de liens .18
7.13 Collections d’entités .18
7.13.1 Fonctionnement .18
7.13.2 Réponse .18
7.13.3 Situations d’erreur .24
7.14 Collection d’entités . 25
7.14.1 Fonctionnement . 25
iii
7.14.2 Réponse . 25
7.14.3 Situations d’erreur . 25
7.15 Entités . 25
7.15.1 Fonctionnement . 25
7.15.2 Paramètre limit . 26
7.15.3 Paramètre bbox .27
7.15.4 Paramètre datetime . 28
7.15.5 Paramètres de filtrage des propriétés d’entités . 30
7.15.6 Combinaisons de paramètres de filtrage . 30
7.15.7 Réponse .31
7.15.8 Situations d’erreur . 33
7.16 Entité . 34
7.16.1 Fonctionnement . 34
7.16.2 Réponse . 34
7.16.3 Situations d’erreur . 34
8 Classes d’exigences pour encodages .
...
Questions, Comments and Discussion
Ask us and Technical Secretary will try to provide an answer. You can facilitate discussion about the standard in here.