ISO 19168-1:2020
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 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.
| Get this standard | Prices exclude GST | |
|---|---|---|
| PDF ( Single user document) |
$141.75 NZD
|
|
| HardCopy |
$194.63 NZD
|
|
| Networkable PDF |
Price varies
|
Foreword
Introduction
1 Scope
2 Normative references
3 Terms, definitions and abbreviated terms
3.1 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"
9 Requirements class "OpenAPI 3.0"
9.1 Basic requirements
9.2 Complete definition
9.3 Exceptions
9.4 Security
9.5 Features
10 Media types
11 Security considerations
11.1 General
11.2 Multiple access routes
11.3 Multiple servers
11.4 Path manipulation on GET
11.5 Path manipulation on PUT and POST
Annex A (normative) Abstract test suite
Bibliography
Keep me up-to-date
Sign up to receive updates when there are changes to this standard
Related Information
Similar Standards
-
AS/NZS 4819:2011
Rural and urban addressing -
AS/NZS ISO 19101.1:2015
Geographic information - Reference model - Part 1: Fundamentals -
AS/NZS ISO 19101.2:2019
Geographic information - Reference model Part 2: Imagery -
AS/NZS ISO 19103:2025
Geographic information – Conceptual schema language
Foreword
Introduction
1 Scope
2 Normative references
3 Terms, definitions and abbreviated terms
3.1 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"
9 Requirements class "OpenAPI 3.0"
9.1 Basic requirements
9.2 Complete definition
9.3 Exceptions
9.4 Security
9.5 Features
10 Media types
11 Security considerations
11.1 General
11.2 Multiple access routes
11.3 Multiple servers
11.4 Path manipulation on GET
11.5 Path manipulation on PUT and POST
Annex A (normative) Abstract test suite
Bibliography