You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: extensions/schemas/standard/clause_0_front_material.adoc
+12-6Lines changed: 12 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,11 +4,15 @@ OGC API Standards define modular API building blocks to spatially enable Web API
4
4
5
5
OGC API - Features Standard defines building blocks to create, modify and query features on the Web. The OGC API - Features Standard is comprised of multiple parts. Each part is a separate standard.
6
6
7
-
The OGC API - Features - Part 5: Schemas Standard (hereafter also referred to as "this Standard" or "this document") specifies how geospatial data such as features can be described by a logical schema and how such schemas are published in an OGC Web API implementation.
7
+
Some API building blocks are applicable in multiple OGC API Standards. These common building blocks are documented in the OGC API — Common Standard, which is comprised of multiple parts, too.
8
+
9
+
This document ("Schemas") specifies how geospatial data such as features can be described by a logical schema and how such schemas are published in an OGC Web API implementation. The document is published both as Part 5 of OGC API - Features and as Part 3 of OGC API - Common. This document is hereafter also referred to as "this Standard".
10
+
11
+
This Standard specifies provisions for schemas that are applicable to any type of geospatial data as well as provisions for profiles. While the provision originate from use cases involving feature data, all provisions are not specific to features.
8
12
9
13
As logical schemas, the schemas describe the data independent of a particular format to represent the data.
10
14
11
-
To use a schema for data validation, the schema must be converted into a schema representation suitable for validating data in the specific data format. For example, an XML Schema that is a GML application schema or a JSON Schema for GeoJSON or the draft OGC Features and Geometries JSON (JSON-FG).
15
+
To use a schema for data validation, the schema must be converted into a schema representation suitable for validating data in the specific data format. For example, an XML Schema that is a GML application schema or a JSON Schema for GeoJSON or JSON-FG (OGC Features and Geometries JSON).
12
16
13
17
While the schema is a logical schema, a machine-readable representation is needed. Instead of specifying a custom schema language for geospatial data, this Standard uses JSON Schema as the schema language with:
14
18
@@ -23,10 +27,6 @@ The main reasons for using JSON Schema are:
23
27
* JSON data types (string, number, boolean, array, object, null) are simple and easy to understand; and
24
28
* JSON is often used for encoding geospatial data, i.e., the schema of a property can be used to validate property values without conversion.
25
29
26
-
This Standard specifies basic provisions for schemas that are applicable to any type of geospatial data as well as general provision for profiles. These provisions are not specific to features and as such could be copied in or moved to OGC API - Common in the future.
27
-
28
-
Additional provisions are added for <<rc_advanced-property-roles,schemas for feature data>>.
29
-
30
30
In OGC Web APIs, geospatial data is shared in collections (path `/collections/{collectionId}`). The schema of items in a collection provides information as to how to interact with the collection.
31
31
32
32
Examples of interactions, where information about the schema are required, include:
@@ -72,9 +72,12 @@ Recipients of this document are requested to submit, with their comments, notifi
72
72
73
73
The following organizations submitted this document to the Open Geospatial Consortium (OGC):
74
74
75
+
* Compass, Inc.
75
76
* CubeWerx Inc.
76
77
* Ecere Corporation
78
+
* Geonovum
77
79
* interactive instruments
80
+
* Met Office
78
81
* Meteorological Service of Canada
79
82
* Natural Resources Canada
80
83
@@ -86,7 +89,10 @@ All questions regarding this submission should be directed to the editors or the
86
89
|*Name* |*Affiliation*
87
90
|Panagiotis (Peter) A. Vretanos _(editor)_ |CubeWerx Inc.
0 commit comments