Add load_http #415

CHANGELOG.md

@@ -12,6 +12,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
     - `date_difference`
     - `filter_vector`
     - `flatten_dimensions`
+    - `load_http`
     - `unflatten_dimension`
     - `vector_buffer`
     - `vector_reproject`

proposals/load_http.json

@@ -0,0 +1,53 @@
+{
+    "id": "load_http",
+    "summary": "Load files from the internet (HTTP)",
+    "description": "Loads a file from a URL (supported protocols: HTTP and HTTPS).",
+    "categories": [
+        "cubes",
+        "import"
+    ],
+    "experimental": true,
+    "parameters": [
+        {
+            "name": "url",
+            "description": "The HTTP(S) URLs to read. Authentication details such as API keys or tokens may need to be included in the URL.",
+            "schema": {
+                "title": "URL",
+                "type": "string",
+                "format": "uri",
+                "subtype": "uri",
+                "pattern": "^https?://"
+            }
+        },
+        {
+            "name": "format",
+            "description": "The file format to read from. It must be one of the values that the server reports as supported input file formats, which usually correspond to the short GDAL/OGR codes. If the format is not suitable for loading the data, a `FormatUnsuitable` exception will be thrown. This parameter is *case insensitive*.",
+            "schema": {
+                "type": "string",
+                "subtype": "input-format"
+            }
+        },
+        {
+            "name": "options",
+            "description": "The file format parameters to be used to read the files. Must correspond to the parameters that the server reports as supported parameters for the chosen `format`. The parameter names and valid values usually correspond to the GDAL/OGR format options.",
+            "schema": {
+                "type": "object",
+                "subtype": "input-format-options"
+            },
+            "default": {},
+            "optional": true
+        }
+    ],
+    "returns": {
+        "description": "A data cube for further processing.",
+        "schema": {
+            "type": "object",
+            "subtype": "datacube"
+        }
+    },
+    "exceptions": {
+        "FormatUnsuitable": {
+            "message": "Data can't be loaded with the requested input format."
+        }
+    }
+}