AS/NZS ISO 19168.1:2025 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
Table of contents
Header
About this publication
Preface
Foreword
Introduction
1 Scope
2 Normative references
3 Terms and definitions
3.1 Terms and definitions
3.2 Abbreviated terms
4 Conformance
5 Conventions
5.1 Identifiers
5.2 Link relations
5.3 Use of HTTPS
5.4 HTTP URIs
5.5 API definition
5.5.1 General remarks
5.5.2 Role of OpenAPI
5.5.3 References to OpenAPI components in normative statements
5.5.4 Paths in OpenAPI definitions
5.5.5 Reusable OpenAPI components
6 Overview
6.1 Design considerations
6.2 Encodings
6.3 Examples
7 Requirements class “Core”
7.1 Overview
7.2 API landing page
7.2.1 Operation
7.2.2 Response
7.2.3 Error situations
7.3 API definition
7.3.1 Operation
7.3.2 Response
7.3.3 Error situations
7.4 Declaration of conformance classes
7.4.1 Operation
7.4.2 Response
7.4.3 Error situations
7.5 HTTP 1.1
7.5.1 HTTP status codes
7.6 Unknown or invalid query parameters
7.7 Web caching
7.8 Support for cross-origin requests
7.9 Encodings
7.10 String internationalization
7.11 Coordinate reference systems
7.12 Link headers
7.13 Feature collections
7.13.1 Operation
7.13.2 Response
7.13.3 Error situations
7.14 Feature collection
7.14.1 Operation
7.14.2 Response
7.14.3 Error situations
7.15 Features
7.15.1 Operation
7.15.2 Parameter limit
7.15.3 Parameter bbox
7.15.4 Parameter datetime
7.15.5 Parameters for filtering on feature properties
7.15.6 Combinations of filter parameters
7.15.7 Response
7.15.8 Error situations
7.16 Feature
7.16.1 Operation
7.16.2 Response
7.16.3 Error situations
8 Requirements classes for encodings
8.1 Overview
8.2 Requirements class “HTML”
8.3 Requirements class “GeoJSON”
8.4 Requirements class “Geography Markup Language (GML), Simple Features Profile, Level 0”
8.5 Requirements class “Geography Markup Language (GML), Simple Features Profile, Level 2”
