Adds support for IAU codes.

Author: jlaura

CHANGELOG.md

@@ -9,10 +9,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [v1.1.0] - 2023-02-10
 
 ### Added
-
-- Added examples for Collections and Assets (in Items)
-
-### Changed
+- Definition for authority and code instead of a hard coded EPSG. The EPSG code field was maintained for backwards compatibility.
 
 - `proj:epsg` is not required in Item properties anymore. `proj:epsg` is recommended now, but not required in any scope.
 - Updated the PROJJSON schema to v0.5

README.md

@@ -37,7 +37,9 @@ The fields in the table below can be used in these parts of STAC documents:
 
 | Field Name       | Type                     | Description |
 | ---------------- | ------------------------ | ----------- |
-| proj:epsg        | integer\|null   | [EPSG code](http://www.epsg-registry.org/) of the datasource |
+| proj:code        | integer\|null   | **REQUIRED.** [EPSG code](http://www.epsg-registry.org/) or other code (e.g., [IAU](http://voparis-vespa-crs.obspm.fr:8080/web/2015.html)) of the datasource |
+| proj:authority   | string\|null    | The name of the authority that designated the proj:code of the datasource. Default: `epsg`. |
+| proj:epsg        | integer\|null   |  [EPSG code](http://www.epsg-registry.org/) of the datasource; Maintained for backwards compatability. Please use `proj:authority` and `proj:code`. |
 | proj:wkt2        | string\|null    | [WKT2](http://docs.opengeospatial.org/is/12-063r5/12-063r5.html) string representing the Coordinate Reference System (CRS) that the `proj:geometry` and `proj:bbox` fields represent |
 | proj:projjson    | [PROJJSON Object](https://proj.org/specifications/projjson.html)\|null | PROJJSON object representing the Coordinate Reference System (CRS) that the `proj:geometry` and `proj:bbox` fields represent |
 | proj:geometry    | [GeoJSON Geometry Object](https://tools.ietf.org/html/rfc7946#section-3.1) | Defines the footprint of this Item. |

examples/item_custom_proj.json

@@ -0,0 +1,95 @@
+{
+  "stac_version": "1.0.0-rc.1",
+  "stac_extensions": [
+    "https://stac-extensions.github.io/projection/v1.0.0/schema.json"
+  ],
+  "type": "Feature",
+  "id": "20201211_223832_CS2",
+  "bbox": [
+    172.91173669923782,
+    1.3438851951615003,
+    172.95469614953714,
+    1.3690476620161975
+  ],
+  "geometry": {
+    "type": "Polygon",
+    "coordinates": [
+      [
+        [
+          172.91173669923782,
+          1.3438851951615003
+        ],
+        [
+          172.95469614953714,
+          1.3438851951615003
+        ],
+        [
+          172.95469614953714,
+          1.3690476620161975
+        ],
+        [
+          172.91173669923782,
+          1.3690476620161975
+        ],
+        [
+          172.91173669923782,
+          1.3438851951615003
+        ]
+      ]
+    ]
+  },
+  "properties": {
+    "datetime": "2020-12-11T22:38:32.125Z",
+    "created": "2020-12-12T01:48:13.725Z",
+    "updated": "2020-12-12T01:48:13.725Z",
+    "platform": "cool_sat2",
+    "instruments": [
+      "cool_sensor_v1"
+    ],
+    "gsd": 0.66,
+    "proj:autority": "iau_2015",
+    "proj:code": "49900",
+    "proj:shape": [
+      5558,
+      9559
+    ],
+    "proj:transform": [
+      0.5,
+      0,
+      712710,
+      0,
+      -0.5,
+      151406,
+      0,
+      0,
+      1
+    ]
+  },
+  "links": [],
+  "assets": {
+    "analytic": {
+      "href": "https://storage.googleapis.com/open-cogs/stac-examples/20201211_223832_CS2_analytic.tif",
+      "type": "image/tiff; application=geotiff; profile=cloud-optimized",
+      "title": "4-Band Analytic",
+      "roles": [
+        "data"
+      ]
+    },
+    "thumbnail": {
+      "href": "https://storage.googleapis.com/open-cogs/stac-examples/20201211_223832_CS2.jpg",
+      "title": "Thumbnail",
+      "type": "image/png",
+      "roles": [
+        "thumbnail"
+      ]
+    },
+    "visual": {
+      "href": "https://storage.googleapis.com/open-cogs/stac-examples/20201211_223832_CS2.tif",
+      "type": "image/tiff; application=geotiff; profile=cloud-optimized",
+      "title": "3-Band Visual",
+      "roles": [
+        "visual"
+      ]
+    }
+  }
+}

json-schema/schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://stac-extensions.github.io/projection/v1.1.0/schema.json",
+  "$id": "https://stac-extensions.github.io/projection/v2.0.0/schema.json",
   "title": "Projection Extension",
   "description": "STAC Projection Extension for STAC Items.",
   "$comment": "This schema succeeds if the proj: fields are not used at all, please keep this in mind.",
@@ -23,7 +23,17 @@
               "const": "Feature"
             },
             "properties": {
-              "$ref": "#/definitions/fields"
+              "allOf": [
+                {
+                  "$comment": "Require fields here for item properties.",
+                  "required": [
+                    "proj:code"
+                  ]
+                },
+                {
+                  "$ref": "#/definitions/fields"
+                }
+              ]
             },
             "assets": {
               "type": "object",
@@ -85,6 +95,21 @@
     "fields": {
       "type": "object",
       "properties": {
+        "proj:authority":{
+          "title":"Authority granting the code",
+          "type":[
+            "string",
+            "null"
+          ],
+          "default":"epsg"
+        },
+        "proj:code":{
+          "title":"Projection code",
+          "type":[
+            "integer",
+            "null"
+          ]
+        },
         "proj:epsg":{
           "title":"EPSG code",
           "type":[