Add product:timeliness_category

Author: m-mohr

README.md

@@ -27,10 +27,14 @@ The fields in the table below can be used in these parts of STAC documents:
 - [x] Assets (for both Collections and Items, incl. Item Asset Definitions in Collections)
 - [ ] Links
 
-| Field Name         | Type   | Description       |
-| ------------------ | ------ | ----------------- |
-| product:type       | string | The product type. |
-| product:timeliness | string | The average expected timeliness of the product as an [ISO 8601 Duration](https://en.wikipedia.org/wiki/ISO_8601#Durations). |
+| Field Name                  | Type   | Description       |
+| --------------------------- | ------ | ----------------- |
+| product:type                | string | The product type. |
+| product:timeliness          | string | The average expected timeliness of the product as an [ISO 8601 Duration](https://en.wikipedia.org/wiki/ISO_8601#Durations). |
+| product:timeliness_category | string | A proprietary category identifier for the timeliness of the product. |
+
+> \[!IMPORTANT]  
+> `product:timeliness` is REQUIRED if `product:timeliness_category` is provided.
 
 ### Additional Field Information
 

examples/collection.json

@@ -36,6 +36,9 @@
     ],
     "product:timeliness": [
       "PT3H"
+    ],
+    "product:timeliness_category": [
+      "NRT"
     ]
   },
   "links": [

examples/item.json

@@ -15,7 +15,8 @@
       "c-sar"
     ],
     "product:type": "GRD",
-    "product:timeliness": "PT3H"
+    "product:timeliness": "PT3H",
+    "product:timeliness_category": "NRT"
   },
   "geometry": {
     "type": "Polygon",

json-schema/schema.json

@@ -105,12 +105,20 @@
   "definitions": {
     "fields": {
       "type": "object",
+      "dependencies": {
+        "product:timeliness_category": [
+          "product:timeliness"
+        ]
+      },
       "properties": {
         "product:type": {
           "$ref": "#/definitions/product:type"
         },
         "product:timeliness": {
           "$ref": "#/definitions/product:timeliness"
+        },
+        "product:timeliness_category": {
+          "$ref": "#/definitions/product:timeliness_category"
         }
       },
       "patternProperties": {
@@ -126,6 +134,9 @@
       "type": "string",
       "format": "duration"
     },
+    "product:timeliness_category": {
+      "type": "string"
+    },
     "json_schema": {
       "$comment": "JSON Schema",
       "type": "object"