Standard
Track updates
AS/NZS ISO 19168.1:2025
[Current]Geographic information - Geospatial API for features, Part 1: Core
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
Published: 17/04/2025
Pages: 62
Table of contents
Cited references
Content history
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"
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
A.1 General
A.2 Conformance class core
A.2.1 General tests
A.2.1.1 HTTP
A.2.1.2 CRS 84
A.2.2 Landing page {root}/
A.2.3 API definition path {root}/api (link)
A.2.4 Conformance path {root}/conformance
A.2.5 Feature collections {root}/collections
A.2.6 Feature collection {root}/collections/{collectionId}
A.2.7 Features {root}/collections/{collectionId}/items
A.2.8 Feature
A.3 Conformance class GeoJSON
A.3.1 Conformance class
A.3.2 GeoJSON definition
A.3.3 GeoJSON content
A.4 Conformance class GML simple features level 0
A.4.1 Conformance class
A.4.2 GML simple features 0 definition
A.4.3 GML simple features 0 content
A.5 Conformance class GML simple features level 2
A.5.1 Conformance class
A.5.2 GML simple features 2 definition
A.5.3 GML simple features 2 content
A.6 Conformance class HTML
A.6.1 Conformance class
A.6.2 HTML definition
A.6.3 HTML content
A.7 Conformance class OpenAPI 3.0
Bibliography
Cited references in this standard
Content history
[Current]
[Superseded]
DR AS/NZS ISO 19168.1:2025
One-time Purchase
Access via web browser on any device
One-time purchase
Single publication
Offline access via PDF^
$242.19 AUD
Inclusive of GSTFormat *
Web Reader
Licenses *
1 License (for yourself - not shareable)
Total$242.19 AUD
IMPORTANT