Standard
UPDATE AVAILABLE
AS/NZS ISO 19168.1:2021
[Superseded]Geographic information - Geospatial API for features, Part 1: Core
Identically adopts ISO 19168-1:2020, specifying the behaviour of Web APIs that provide access to features in a data set in a manner independent of the underlying data store. Defines discovery and query operations. KEYWORDS: Web; APIs; Data set; Discovery; Query
Published: 12/02/2021
Pages: 55
Table of contents
Cited references
Content history
Table of contents
Header
About this publication
Preface
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
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 GeoJSON definition
A.3.2 GeoJSON content
A.4 Conformance class GML simple features level 0
A.4.1 GML simple features 0 definition
A.4.2 GML simple features 0 content
A.5 Conformance class GML simple features level 2
A.5.1 GML simple features 2 definition
A.5.2 GML simple features 2 content
A.6 Conformance class HTML
A.6.1 HTML definition
A.6.2 HTML content
A.7 Conformance class OpenAPI 3.0
Bibliography
Cited references in this standard
Content history
[Superseded]
AS/NZS ISO 19168.1:2025
[Current]DR AS/NZS ISO 19168.1:2020
One-time Purchase
Access via web browser on any device
One-time purchase
Single publication
Offline access via PDF^
$193.74 AUD
Inclusive of GSTFormat *
Web Reader
Licenses *
1 License (for yourself - not shareable)
Total$193.74 AUD
IMPORTANT