EN ISO 19168-1:2021
(Main)Geographic information - Geospatial API for features - Part 1: Core (ISO 19168-1:2020)
Geographic information - Geospatial API for features - Part 1: Core (ISO 19168-1:2020)
This document specifies the behaviour of Web APIs that provide access to features in a dataset in a manner independent 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.
Geoinformation - Raumbezogene API für Features - Teil 1: Kern (ISO 19168-1:2020)
Information géographique - API géospatiale pour les entités - Partie 1: Profil minimal (ISO 19168-1:2020)
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.
Geografske informacije - Geoprostorski API za funkcije - 1. del: Osrednji profil (ISO 19168-1:2020)
General Information
Relations
Standards Content (Sample)
SLOVENSKI STANDARD
01-september-2021
Geografske informacije - Geoprostorski API za funkcije - 1. del: Osrednji profil (ISO
19168-1:2020)
Geographic information - Geospatial API for features - Part 1: Core (ISO 19168-1:2020)
Information géographique - API géospatiale pour les entités - Partie 1: Profil minimal
(ISO 19168-1:2020)
Ta slovenski standard je istoveten z: EN ISO 19168-1:2021
ICS:
07.040 Astronomija. Geodezija. Astronomy. Geodesy.
Geografija Geography
35.240.70 Uporabniške rešitve IT v IT applications in science
znanosti
2003-01.Slovenski inštitut za standardizacijo. Razmnoževanje celote ali delov tega standarda ni dovoljeno.
EN ISO 19168-1
EUROPEAN STANDARD
NORME EUROPÉENNE
June 2021
EUROPÄISCHE NORM
ICS 35.240.70
English Version
Geographic information - Geospatial API for features - Part
1: Core (ISO 19168-1:2020)
Information géographique - API géospatiale pour les Geoinformation - Raumbezogene API für Features -
entités - Partie 1: Profil minimal (ISO 19168-1:2020) Teil 1: Kern (ISO 19168-1:2020)
This European Standard was approved by CEN on 21 June 2021.
CEN members are bound to comply with the CEN/CENELEC Internal Regulations which stipulate the conditions for giving this
European Standard the status of a national standard without any alteration. Up-to-date lists and bibliographical references
concerning such national standards may be obtained on application to the CEN-CENELEC Management Centre or to any CEN
member.
This European Standard exists in three official versions (English, French, German). A version in any other language made by
translation under the responsibility of a CEN member into its own language and notified to the CEN-CENELEC Management
Centre has the same status as the official versions.
CEN members are the national standards bodies of Austria, Belgium, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark, Estonia,
Finland, France, Germany, Greece, Hungary, Iceland, Ireland, Italy, Latvia, Lithuania, Luxembourg, Malta, Netherlands, Norway,
Poland, Portugal, Republic of North Macedonia, Romania, Serbia, Slovakia, Slovenia, Spain, Sweden, Switzerland, Turkey and
United Kingdom.
EUROPEAN COMMITTEE FOR STANDARDIZATION
COMITÉ EUROPÉEN DE NORMALISATION
EUROPÄISCHES KOMITEE FÜR NORMUNG
CEN-CENELEC Management Centre: Rue de la Science 23, B-1040 Brussels
© 2021 CEN All rights of exploitation in any form and by any means reserved Ref. No. EN ISO 19168-1:2021 E
worldwide for CEN national Members.
Contents Page
European foreword . 3
European foreword
The text of ISO 19168-1:2020 has been prepared by Technical Committee ISO/TC 211 "Geographic
information/Geomatics” of the International Organization for Standardization (ISO) and has been taken
over as EN ISO 19168-1:2021 by Technical Committee CEN/TC 287 “Geographic Information” the
secretariat of which is held by BSI.
This European Standard shall be given the status of a national standard, either by publication of an
identical text or by endorsement, at the latest by December 2021, and conflicting national standards
shall be withdrawn at the latest by December 2021.
Attention is drawn to the possibility that some of the elements of this document may be the subject of
patent rights. CEN shall not be held responsible for identifying any or all such patent rights.
According to the CEN-CENELEC Internal Regulations, the national standards organizations of the
following countries are bound to implement this European Standard: Austria, Belgium, Bulgaria,
Croatia, Cyprus, Czech Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary, Iceland,
Ireland, Italy, Latvia, Lithuania, Luxembourg, Malta, Netherlands, Norway, Poland, Portugal, Republic of
North Macedonia, Romania, Serbia, Slovakia, Slovenia, Spain, Sweden, Switzerland, Turkey and the
United Kingdom.
Endorsement notice
The text of ISO 19168-1:2020 has been approved by CEN as EN ISO 19168-1:2021 without any
modification.
INTERNATIONAL ISO
STANDARD 19168-1
First edition
2020-09
Geographic information — Geospatial
API for features —
Part 1:
Core
Information géographique — API géospatiale pour les entités —
Partie 1: Profil minimal
Reference number
ISO 19168-1:2020(E)
©
ISO 2020
ISO 19168-1:2020(E)
© ISO 2020
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 © ISO 2020 – All rights reserved
ISO 19168-1:2020(E)
Contents Page
Foreword .v
Introduction .vi
1 Scope . 1
2 Normative references . 1
3 Terms, definitions and abbreviated terms . 1
3.1 Abbreviated terms . 2
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 . 6
6.1 Design considerations. 6
6.2 Encodings . 7
6.3 Examples . 8
7 Requirements class "Core" . 8
7.1 Overview . 8
7.2 API landing page .10
7.2.1 Operation .10
7.2.2 Response .11
7.2.3 Error situations .11
7.3 API definition.12
7.3.1 Operation .12
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 .
...
Questions, Comments and Discussion
Ask us and Technical Secretary will try to provide an answer. You can facilitate discussion about the standard in here.