Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions counterexamples/buildings/bad-sources-empty-provider.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
---
id: overture:buildings:building:1234
type: Feature
geometry:
type: Polygon
coordinates: [[[0, 0], [0, 1], [1, 1], [1, 0], [0, 0]]]
properties:
theme: buildings
type: building
version: 1
sources:
- dataset: MyGreatDataset
property: "/geometry"
provider: ""
resource: ""
version: ""
26 changes: 26 additions & 0 deletions examples/buildings/sources-with-version.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
---
id: overture:buildings:building:1234
type: Feature
geometry:
type: Polygon
coordinates: [[[0, 0], [0, 1], [1, 1], [1, 0], [0, 0]]]
properties:
theme: buildings
type: building
version: 1
sources:
- property: "/geometry"
dataset: osm-planet
provider: osm
resource: planet
version: '2078-08-28T14:44:41Z'
- property: "/properties/name"
dataset: metaML-buildings
provider: meta
resource: ml-buildings
version: 'abcdef'
- property: "/properties/height"
dataset: microsoft-buildings
provider: microsoft
resource: buildings
version: '352'
36 changes: 27 additions & 9 deletions schema/defs.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -260,13 +260,14 @@ description: Common schema definitions shared by all themes
enum: [left, right]
sourcePropertyItem:
description: >-
An object storing the source for a specificed property. The property
An object storing the source for a specified property. The property
is a reference to the property element within this Feature, and will be
referenced using JSON Pointer Notation RFC 6901
(https://datatracker.ietf.org/doc/rfc6901/). The source dataset for
that referenced property will be specified in the overture list of
approved sources from the Overture Data Working Group that contains
the relevant metadata for that dataset including license source organization.
(https://datatracker.ietf.org/doc/rfc6901/). The source is currently
identified by the dataset field, but will, in the future, be replaced
by the combination of provider, resource, and version fields.
Additional metadata such as license, record_id, update_time, and
confidence may also be provided.
type: object
required: [property, dataset]
allOf:
Expand All @@ -292,14 +293,31 @@ description: Common schema definitions shared by all themes
type: number
minimum: 0
maximum: 1
provider:
type: [string, "null"]
description: >-
The Provider Label for the entity that produced this data
(e.g. osm, meta, esri).
minLength: 1
Comment thread
ericgodwin marked this conversation as resolved.
resource:
type: [string, "null"]
description: >-
The subject or type of data provided by the provider (e.g. planet,
buildings, division-names).
minLength: 1
Comment thread
ericgodwin marked this conversation as resolved.
version:
type: [string, "null"]
description: >-
A sortable identifier for the specific snapshot of the resource
(e.g. 2026-02-13, 5.3, A5692).
minLength: 1
sources:
description: >-
The array of source information for the properties of a
given feature, with each entry being a source object which
lists the property in JSON Pointer notation and the dataset
that specific value came from. All features must have a root
level source which is the default source if a specific
property's source is not specified.
lists the property in JSON Pointer notation. All features
must have a root level source which is the default source
if a specific property's source is not specified.
Comment thread
ericgodwin marked this conversation as resolved.
type: array
items: {"$ref" : "#/$defs/propertyDefinitions/sourcePropertyItem"}
minItems: 1
Expand Down