OvertureMaps · Eric Godwin (ericgodwin) · May 19, 2026 · May 19, 2026
diff --git a/counterexamples/base/bathymetry/bad-depth.yaml b/counterexamples/base/bathymetry/bad-depth.yaml
@@ -13,5 +13,8 @@ properties:
     - record_id: x123
       property: ""
       dataset: some source
+      provider: some_provider
+      resource: some_resource
+      version: "2087-08-23"
   ext_expected_errors:
     - "depth/minimum]: minimum: got -1, want 0"
diff --git a/counterexamples/buildings/bad-confidence-in-source.yaml b/counterexamples/buildings/bad-confidence-in-source.yaml
@@ -14,8 +14,14 @@ properties:
   height: 21.34
   sources:
   - property: ""
-    dataset: microsoftMLBuildings,
+    dataset: microsoftMLBuildings
+    provider: microsoft
+    resource: ml-buildings
+    version: abc
     confidence: 100
   - property: /properties/height
-    dataset:  metaLidarExtractions,
+    dataset:  metaLidarExtractions
+    provider: meta
+    resource: lidar-extractions
+    version: "2087-08-23"
     confidence: -1
diff --git a/counterexamples/buildings/bad-license.yaml b/counterexamples/buildings/bad-license.yaml
@@ -11,6 +11,9 @@ properties:
   version: 1
   sources:
     - dataset: MyGreatDataset
+      provider: overture
+      resource: soccer-stadiums
+      version: "2087-08-23"
       property: "/geometry"
       update_time: '2024-04-26T23:55:01-08:00'
       confidence: 0.3

diff --git a/counterexamples/buildings/bad-time.yaml b/counterexamples/buildings/bad-time.yaml
@@ -12,5 +12,8 @@ properties:
   version: 1
   sources:
     - dataset: OpenStreetMap
+      provider: osm
+      resource: planet
+      version: "2099-05-18T10:30:00Z"
       property: "/blah"
       update_time: abc2023-02-22T23:55:01-08:00
diff --git a/counterexamples/buildings/building-part-bad-name.yaml b/counterexamples/buildings/building-part-bad-name.yaml
@@ -30,3 +30,6 @@ properties:
   sources:
   - property: ""
     dataset: OpenStreetMap
+    provider: osm
+    resource: planet
+    version: "2099-05-18T10:30:00Z"
diff --git a/counterexamples/places/bad-empty-emails.yaml b/counterexamples/places/bad-empty-emails.yaml
@@ -33,9 +33,15 @@ properties:
   sources:
     - property: ""
       dataset: metaPlaces
+      provider: meta
+      resource: places
+      version: "2087-08-23"
       record_id: "10101"
     - property: "/properties/brand"
       dataset: msftPlaces
+      provider: microsoft
+      resource: places
+      version: abc
       record_id: "10df72b8"
   names:
     primary: My Sweet POI

diff --git a/counterexamples/places/bad-empty-phones.yaml b/counterexamples/places/bad-empty-phones.yaml
@@ -33,9 +33,15 @@ properties:
   sources:
     - property: ""
       dataset: metaPlaces
+      provider: meta
+      resource: places
+      version: "2087-08-23"
       record_id: "10101"
     - property: "/properties/brand"
       dataset: msftPlaces
+      provider: microsoft
+      resource: places
+      version: abc
       record_id: "10df72b8"
   names:
     primary: My Sweet POI

diff --git a/counterexamples/places/bad-empty-socials.yaml b/counterexamples/places/bad-empty-socials.yaml
@@ -33,9 +33,15 @@ properties:
   sources:
     - property: ""
       dataset: metaPlaces
+      provider: meta
+      resource: places
+      version: "2087-08-23"
       record_id: "10101"
     - property: "/properties/brand"
       dataset: msftPlaces
+      provider: microsoft
+      resource: places
+      version: abc
       record_id: "10df72b8"
   names:
     primary: My Sweet POI

diff --git a/counterexamples/places/bad-empty-websites.yaml b/counterexamples/places/bad-empty-websites.yaml
@@ -33,9 +33,15 @@ properties:
   sources:
     - property: ""
       dataset: metaPlaces
+      provider: meta
+      resource: places
+      version: "2087-08-23"
       record_id: "10101"
     - property: "/properties/brand"
       dataset: msftPlaces
+      provider: microsoft
+      resource: places
+      version: abc
       record_id: "10df72b8"
   names:
     primary: My Sweet POI

diff --git a/counterexamples/places/bad-operating-status.yaml b/counterexamples/places/bad-operating-status.yaml
@@ -33,9 +33,15 @@ properties:
   sources:
     - property: ""
       dataset: metaPlaces
+      provider: meta
+      resource: places
+      version: "2087-08-23"
       record_id: "10101"
     - property: "/properties/brand"
       dataset: msftPlaces
+      provider: microsoft
+      resource: places
+      version: abc
       record_id: "10df72b8"
   names:
     primary: My Sweet POI

diff --git a/counterexamples/transportation/segment/bad-source-between.yaml b/counterexamples/transportation/segment/bad-source-between.yaml
@@ -21,4 +21,7 @@ properties:
     - record_id: w123
       property: ""
       dataset: some source
+      provider: some_provider
+      resource: some_resource
+      version: "2087-08-23"
       between: []
diff --git a/docs/schema/0-Schema.mdx b/docs/schema/0-Schema.mdx
@@ -49,7 +49,7 @@ In the Overture schema, all features have a unique `id` called a [GERS ID](https
 | **theme** | *string* | one of six Overture data themes |
 | **type** | *string* | one of 14 Overture feature types | 
 | **version** | *int32* | version number of the feature, incremented in each Overture release where the geometry or attributes of this feature changed |
-| **sources** | *list\<element: struct\<property: string, dataset: string, record_id: string, update_time: string, confidence: double, between: list\<double\>\>\>* | array of source information for the properties of a given feature |
+| **sources** | *list\<element: struct\<property: string, dataset: string, provider: string, resource: string, version: string, record_id: string, update_time: string, confidence: double, between: list\<double\>\>\>* | array of source information for the properties of a given feature |
 </details>
 
 ### Other key schema properties

diff --git a/examples/base/bathymetry-example.yaml b/examples/base/bathymetry-example.yaml
@@ -16,4 +16,7 @@ properties:
     - record_id: x123
       property: ""
       dataset: some source
+      provider: some_provider
+      resource: some_resource
+      version: "2087-08-23"
   version: 0
diff --git a/examples/base/infrastructure-example.yaml b/examples/base/infrastructure-example.yaml
@@ -18,4 +18,7 @@ properties:
     - property: ""
       record_id: w556368546@3
       dataset: OpenStreetMap
+      provider: osm
+      resource: planet
+      version: "2099-05-18T10:30:00Z"
   version: 0
diff --git a/examples/base/infrastructure-height-example.yaml b/examples/base/infrastructure-height-example.yaml
@@ -16,4 +16,7 @@ properties:
     - property: ""
       record_id: n10707323715@5
       dataset: OpenStreetMap
+      provider: osm
+      resource: planet
+      version: "2099-05-18T10:30:00Z"
   version: 0
diff --git a/examples/base/land-cover-example.yaml b/examples/base/land-cover-example.yaml
@@ -16,4 +16,7 @@ properties:
     - record_id: x123
       property: ""
       dataset: some source
+      provider: some_provider
+      resource: some_resource
+      version: "2087-08-23"
   version: 0
diff --git a/examples/base/land-sand-example.yaml b/examples/base/land-sand-example.yaml
@@ -18,4 +18,7 @@ properties:
     - record_id: w407753930@3
       property: ""
       dataset: OpenStreetMap
+      provider: osm
+      resource: planet
+      version: "2099-05-18T10:30:00Z"
   version: 0
diff --git a/examples/base/land-use-example.yaml b/examples/base/land-use-example.yaml
@@ -19,4 +19,7 @@ properties:
     - record_id: w509487233@1
       property: ""
       dataset: OpenStreetMap
+      provider: osm
+      resource: planet
+      version: "2099-05-18T10:30:00Z"
   version: 0
diff --git a/examples/base/water-body-disputed.yaml b/examples/base/water-body-disputed.yaml
@@ -31,6 +31,9 @@ properties:
     - record_id: w1234567
       property: ""
       dataset: OpenStreetMap
+      provider: osm
+      resource: planet
+      version: "2099-05-18T10:30:00Z"
   is_salt: false
   is_intermittent: false
   version: 0
diff --git a/examples/base/water-river-example.yaml b/examples/base/water-river-example.yaml
@@ -17,6 +17,9 @@ properties:
     - record_id: w54320702@1
       property: ""
       dataset: OpenStreetMap
+      provider: osm
+      resource: planet
+      version: "2099-05-18T10:30:00Z"
   is_salt: false
   is_intermittent: false
   version: 0
diff --git a/examples/base/water-river-with-wikidata.yaml b/examples/base/water-river-with-wikidata.yaml
@@ -17,5 +17,8 @@ properties:
     - record_id: w353912370@4
       property: ""
       dataset: OpenStreetMap
+      provider: osm
+      resource: planet
+      version: "2099-05-18T10:30:00Z"
   wikidata: Q7420045
   version: 0
diff --git a/examples/buildings/basic-sources.yaml b/examples/buildings/basic-sources.yaml
@@ -14,6 +14,9 @@ properties:
   version: 1
   sources:
     - dataset: MyGreatDataset
+      provider: overture
+      resource: soccer-stadiums
+      version: "2087-08-23"
       property: "/geometry"
       update_time: '2024-04-26T23:55:01-08:00'
       confidence: 0.3
diff --git a/examples/buildings/building-part-basic.yaml b/examples/buildings/building-part-basic.yaml
@@ -31,5 +31,11 @@ properties:
   sources:
   - property: ""
     dataset: microsoftMLBuildings
+    provider: microsoft
+    resource: ml-buildings
+    version: abc
   - property: /properties/height
     dataset:  metaLidarExtractions
+    provider: meta
+    resource: lidar-extractions
+    version: "2087-08-23"
diff --git a/examples/buildings/building-part-name.yaml b/examples/buildings/building-part-name.yaml
@@ -30,3 +30,6 @@ properties:
   sources:
   - property: ""
     dataset: OpenStreetMap
+    provider: osm
+    resource: planet
+    version: "2099-05-18T10:30:00Z"
diff --git a/examples/buildings/building-polygon.yaml b/examples/buildings/building-polygon.yaml
@@ -27,8 +27,14 @@ properties:
   is_underground: false
   sources:
   - property: ""
-    dataset: microsoftMLBuildings,
+    dataset: microsoftMLBuildings
+    provider: microsoft
+    resource: ml-buildings
+    version: abc
     confidence: 1
   - property: /properties/height
-    dataset:  metaLidarExtractions,
+    dataset:  metaLidarExtractions
+    provider: meta
+    resource: lidar-extractions
+    version: "2087-08-23"
     confidence: 0.95
diff --git a/examples/buildings/empire-state-building.json b/examples/buildings/empire-state-building.json
@@ -20,6 +20,9 @@
       {
         "property": "",
         "dataset": "OpenStreetMap",
+        "provider": "osm",
+        "resource": "planet",
+        "version": "2099-05-18T10:30:00Z",
         "record_id": "w34633854@71"
       }
     ],

diff --git a/examples/buildings/license-basic.yaml b/examples/buildings/license-basic.yaml
@@ -11,6 +11,9 @@ properties:
   version: 1
   sources:
     - dataset: MyGreatDataset
+      provider: overture
+      resource: soccer-stadiums
+      version: "2087-08-23"
       property: "/geometry"
       update_time: '2024-04-26T23:55:01-08:00'
       confidence: 0.3

diff --git a/examples/buildings/osm/outline.yaml b/examples/buildings/osm/outline.yaml
@@ -29,3 +29,6 @@ properties:
   sources:
   - property: ''
     dataset: OpenStreetMap
+    provider: osm
+    resource: planet
+    version: "2099-05-18T10:30:00Z"
diff --git a/examples/buildings/osm/part1.yaml b/examples/buildings/osm/part1.yaml
@@ -27,3 +27,6 @@ properties:
   sources:
   - property: ''
     dataset: OpenStreetMap
+    provider: osm
+    resource: planet
+    version: "2099-05-18T10:30:00Z"
diff --git a/examples/buildings/osm/part2.yaml b/examples/buildings/osm/part2.yaml
@@ -27,3 +27,6 @@ properties:
   sources:
   - property: ''
     dataset: OpenStreetMap
+    provider: osm
+    resource: planet
+    version: "2099-05-18T10:30:00Z"
diff --git a/examples/divisions/division/capital_of.yaml b/examples/divisions/division/capital_of.yaml
@@ -16,6 +16,9 @@ properties:
   sources:
     - property: ""
       dataset: OpenStreetMap
+      provider: osm
+      resource: planet
+      version: "2099-05-18T10:30:00Z"
       record_id: N6968827.V76
   country: SI
   hierarchies:

diff --git a/examples/divisions/division/class.yaml b/examples/divisions/division/class.yaml
@@ -16,6 +16,9 @@ properties:
   sources:
     - property: ""
       dataset: OpenStreetMap
+      provider: osm
+      resource: planet
+      version: "2099-05-18T10:30:00Z"
       record_id: N21040334
   country: DK
   hierarchies:

diff --git a/examples/divisions/division/dependency.yaml b/examples/divisions/division/dependency.yaml
@@ -25,6 +25,9 @@ properties:
   sources:
     - property: ""
       dataset: OpenStreetMap
+      provider: osm
+      resource: planet
+      version: "2099-05-18T10:30:00Z"
       record_id: R4422604.V41
   country: PR
   region: US-PR

diff --git a/examples/divisions/division/multiple_capital_division.yaml b/examples/divisions/division/multiple_capital_division.yaml
@@ -16,6 +16,9 @@ properties:
   sources:
     - property: ""
       dataset: OpenStreetMap
+      provider: osm
+      resource: planet
+      version: "2099-05-18T10:30:00Z"
       record_id: R223407.V254
   country: PL
   region: PL-04

diff --git a/examples/divisions/division/population.yaml b/examples/divisions/division/population.yaml
@@ -16,6 +16,9 @@ properties:
   sources:
     - property: ""
       dataset: OpenStreetMap
+      provider: osm
+      resource: planet
+      version: "2099-05-18T10:30:00Z"
       record_id: R68841.V267
   country: CA
   region: CA-ON

diff --git a/examples/divisions/division/prominence.yaml b/examples/divisions/division/prominence.yaml
@@ -16,6 +16,9 @@ properties:
   sources:
     - property: ""
       dataset: OpenStreetMap
+      provider: osm
+      resource: planet
+      version: "2099-05-18T10:30:00Z"
       record_id: N21040334
   country: DK
   hierarchies:

diff --git a/examples/divisions/division/region.yaml b/examples/divisions/division/region.yaml
@@ -16,6 +16,9 @@ properties:
   sources:
     - property: ""
       dataset: OpenStreetMap
+      provider: osm
+      resource: planet
+      version: "2099-05-18T10:30:00Z"
       record_id: R61320.V468
   country: US
   region: US-NY

diff --git a/examples/places/place-no-emails-phones-socials-websites.yaml b/examples/places/place-no-emails-phones-socials-websites.yaml
@@ -26,9 +26,15 @@ properties:
   sources:
     - property: ""
       dataset: metaPlaces
+      provider: meta
+      resource: places
+      version: abc
       record_id: "10101"
     - property: "/properties/brand"
       dataset: msftPlaces
+      provider: microsoft
+      resource: places
+      version: "2087-08-23"
       record_id: "10df72b8"
   names:
     primary: My Sweet POI