Implement proj:code #26

Author: m-mohr

README.md

@@ -132,11 +132,12 @@ The most important methods are:
    import { Formatters } from '@radiantearth/stac-fields';
    Formatters.allowHtmlInCommonMark = false;
    ```
+* CrsCode (CRS Codes such as `EPSG:1234`)
 * CSV (array to comma-separated values)
 * Date
 * DOI (generate a link for a DOI)
 * Duration (ISO 8601 duration)
-* EPSG (generate a link for an EPSG code)
+* EPSG (generate a link for an EPSG code - deprecated in favor of CrsCode)
 * Extent (array with two values formatted as range)
 * FileDataType (explains the data types defined in the file extension)
 * FileSize (formats a number of bytes into kB, MB, ...)

demo/item.json

@@ -6,7 +6,8 @@
 		"https://stac-extensions.github.io/file/v1.0.0/schema.json",
 		"https://stac-extensions.github.io/view/v1.0.0/schema.json",
 		"https://stac-extensions.github.io/contacts/v0.1.1/schema.json",
-		"https://stac-extensions.github.io/themes/v1.0.0/schema.json"
+		"https://stac-extensions.github.io/themes/v1.0.0/schema.json",
+		"https://stac-extensions.github.io/projection/v2.0.0/schema.json"
 	],
 	"id": "LC08_L1TP_107018_20181001_20181001_01_RT",
 	"type": "Feature",
@@ -62,6 +63,7 @@
 		"language": {
 			"code": "en"
 		},
+		"proj:code": "EPSG:4326",
 		"file:checksum": "1114a94a8fe5ccb19ba61c4c0873d391e987982fbbd3",
 		"file:data_type": "uint16",
 		"file:size": 2048,

fields.json

@@ -1151,6 +1151,11 @@
 			"format": "EPSG",
 			"summary": "v"
 		},
+		"proj:code": {
+			"label": "Code",
+			"format": "CrsCode",
+			"summary": "v"
+		},
 		"proj:wkt2": {
 			"label": "WKT2",
 			"explain": "Well-Known Text, version 2",

formatters.js

@@ -325,18 +325,36 @@ const Formatters = {
 		});
 	},
 
-	formatEPSG(value) {
-		// Remove leading 'epsg:' which people sometimes prepend
+	formatCrsCode(value) {
 		if (typeof value === 'string') {
-			value = value.replace(/^epsg:/i, '');
+			const [authority, code] = value.split(':', 2);
+			switch(authority.toUpperCase()) {
+				case 'EPSG':
+				case 'ESRI':
+				case 'IAU_2015':
+				case 'IGNF':
+				case 'MKG':
+				case 'OGC':
+					return _.toLink(`https://spatialreference.org/ref/${authority.toLowerCase()}/${code}/`, value);
+				default:
+					return DataTypes.string(value);
+			}
 		}
-		value = parseInt(value, 10);
-		if (value > 0) {
-			return _.toLink(`http://epsg.io/${value}`, value);
+		
+		return DataTypes.null();
+	},
+
+	/**
+	 * @deprecated Use formatCrsCode instead
+	 */
+	formatEPSG(value) {
+		if (typeof value === 'number') {
+			return Formatters.formatCrsCode(`EPSG:${value}`);
 		}
-		else {
-			return DataTypes.null();
+		else if (typeof value === 'string') {
+			return Formatters.formatCrsCode(value);
 		}
+		return DataTypes.null();
 	},
 
 	formatExtent(value, field, spec = {}) {