prEN ISO 19168-1

Geographic information - Geospatial API for features - Part 1: Core (ISO/DIS 19168-1:2023)

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.

Geoinformationen - Raumbezogene API für Features - Teil 1: Kern (ISO/DIS 19168-1:2023)

Information géographique - API géospatiale pour les entités - Partie 1: Profil minimal (ISO/DIS 19168-1:2023)

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/DIS 19168-1:2023)

General Information

• Status: Not Published
• Publication Date: 25-Jan-2024
• ICS: 35.240.70 - IT applications in science
• Technical Committee: CEN/TC 287 - Geographic Information
• Current Stage: 6055 - CEN Ratification completed (DOR) - Publishing
• Start Date: 26-Nov-2023
• Completion Date: 26-Nov-2023
• Ref Project: oSIST prEN ISO 19168-1:2023 - Geographic information - Geospatial API for features - Part 1: Core (ISO/DIS 19168-1:2023)

Relations

• Revises: EN ISO 19168-1:2021 - Geographic information - Geospatial API for features - Part 1: Core (ISO 19168-1:2020)
• Effective Date: 20-Feb-2023

Standards Content (Sample)

SLOVENSKI STANDARD
01-oktober-2023
Geografske informacije - Geoprostorski API za funkcije - 1. del: Osrednji profil
(ISO/DIS 19168-1:2023)
Geographic information - Geospatial API for features - Part 1: Core (ISO/DIS 19168-
1:2023)
Geoinformationen - Raumbezogene API für Features - Teil 1: Kern (ISO/DIS 19168-
1:2023)
Information géographique - API géospatiale pour les entités - Partie 1: Profil minimal
(ISO/DIS 19168-1:2023)
Ta slovenski standard je istoveten z: prEN ISO 19168-1
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.

DRAFT INTERNATIONAL STANDARD
ISO/DIS 19168-1
ISO/TC 211 Secretariat: SIS
Voting begins on: Voting terminates on:
2023-08-02 2023-10-25
Geographic information — Geospatial API for features —
Part 1:
Core
Information géographique — API géospatiale pour les entités —
Partie 1: Profil minimal
ICS: 35.240.70
This document is circulated as received from the committee secretariat.
THIS DOCUMENT IS A DRAFT CIRCULATED
FOR COMMENT AND APPROVAL. IT IS
ISO/CEN PARALLEL PROCESSING
THEREFORE SUBJECT TO CHANGE AND MAY
NOT BE REFERRED TO AS AN INTERNATIONAL
STANDARD UNTIL PUBLISHED AS SUCH.
IN ADDITION TO THEIR EVALUATION AS
BEING ACCEPTABLE FOR INDUSTRIAL,
TECHNOLOGICAL, COMMERCIAL AND
USER PURPOSES, DRAFT INTERNATIONAL
STANDARDS MAY ON OCCASION HAVE TO
BE CONSIDERED IN THE LIGHT OF THEIR
POTENTIAL TO BECOME STANDARDS TO
WHICH REFERENCE MAY BE MADE IN
Reference number
NATIONAL REGULATIONS.
ISO/DIS 19168-1:2023(E)
RECIPIENTS OF THIS DRAFT ARE INVITED
TO SUBMIT, WITH THEIR COMMENTS,
NOTIFICATION OF ANY RELEVANT PATENT
RIGHTS OF WHICH THEY ARE AWARE AND TO
PROVIDE SUPPORTING DOCUMENTATION. © ISO 2023

ISO/DIS 19168-1:2023(E)
DRAFT INTERNATIONAL STANDARD
ISO/DIS 19168-1
ISO/TC 211 Secretariat: SIS
Voting begins on: Voting terminates on:

Geographic information — Geospatial API for features —
Part 1:
Core
Information géographique — API géospatiale pour les entités —
Partie 1: Profil minimal
ICS: 35.240.70
This document is circulated as received from the committee secretariat.
THIS DOCUMENT IS A DRAFT CIRCULATED
FOR COMMENT AND APPROVAL. IT IS
© ISO 2023
ISO/CEN PARALLEL PROCESSING
THEREFORE SUBJECT TO CHANGE AND MAY
All rights reserved. Unless otherwise specified, or required in the context of its implementation, no part of this publication may
NOT BE REFERRED TO AS AN INTERNATIONAL
be reproduced or utilized otherwise in any form or by any means, electronic or mechanical, including photocopying, or posting on STANDARD UNTIL PUBLISHED AS SUCH.
the internet or an intranet, without prior written permission. Permission can be requested from either ISO at the address below
IN ADDITION TO THEIR EVALUATION AS
or ISO’s member body in the country of the requester. BEING ACCEPTABLE FOR INDUSTRIAL,
TECHNOLOGICAL, COMMERCIAL AND
ISO copyright office
USER PURPOSES, DRAFT INTERNATIONAL
CP 401 • Ch. de Blandonnet 8
STANDARDS MAY ON OCCASION HAVE TO
BE CONSIDERED IN THE LIGHT OF THEIR
CH-1214 Vernier, Geneva
POTENTIAL TO BECOME STANDARDS TO
Phone: [phone]
WHICH REFERENCE MAY BE MADE IN
Reference number
Email: [e-mail]
NATIONAL REGULATIONS.
Website: www.iso.org ISO/DIS 19168-1:2023(E)
RECIPIENTS OF THIS DRAFT ARE INVITED
Published in Switzerland
TO SUBMIT, WITH THEIR COMMENTS,
NOTIFICATION OF ANY RELEVANT PATENT
RIGHTS OF WHICH THEY ARE AWARE AND TO
ii
PROVIDE SUPPORTING DOCUMENTATION. © ISO 2023

ISO/DIS 19168-1:2023(E)
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 . 6
5.5.1 General remarks . 6
5.5.2 Role of OpenAPI . 6
5.5.3 References to OpenAPI components in normative statements . 6
5.5.4 Paths in OpenAPI definitions . 7
5.5.5 Reusable OpenAPI components . 7
6 Overview . 7
6.1 Design Considerations . 7
6.2 Encodings . 8
6.3 Examples . 9
7 Requirements Class "Core" .9
7.1 Overview . 9
7.2 API landing page . 11
7.2.1 Operation . 11
7.2.2 Response . . 11
7.2.3 Error situations .12
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 . 13
7.4.1 Operation .13
7.4.2 Response . .13
7.4.3 Error situations .13
7.5 HTTP 1.1 . 13
7.5.1 HTTP status codes . 14
7.6 Unknown or invalid query parameters . 15
7.7 Web caching . 15
7.8 Support for cross-origin requests . 15
7.9 Encodings . 16
7.10 String internationalization . 16
7.11 Coordinate reference systems . 17
7.12 Link headers . 17
7.13 Feature collections . 17
7.13.1 Operation . 17
7.13.2 Response . . 18
7.13.3 Error situations . 24
7.14 Feature collection . 24
7.14.1 Operation . 24
iii
ISO/DIS 19168-1:2023(E)
7.14.2 Response . . 24
7.14.3 Error situations .25
7.15 Features .
...