forked from opengeospatial/ogcapi-coverages
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- CoverageJSON, PNG, GeoTIFF and COG - Initial stand-in files for other encodings - Fixed mediatype for CoverageJSON
- Loading branch information
1 parent
7f10cb8
commit 7b0a35c
Showing
16 changed files
with
210 additions
and
18 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,38 @@ | ||
| [[rc_cog]] | ||
| [cols="1,4",width="90%"] | ||
| |=== | ||
| 2+|*Requirements Class* | ||
| 2+|http://www.opengis.net/spec/ogcapi-coverages-1/1.0/req/cog | ||
| |Target type |Web API | ||
| |Dependency |http://www.opengis.net/spec/ogcapi-coverages-1/1.0/req/core | ||
| |Dependency |https://www.itu.int/itudoc/itu-t/com16/tiff-fx/docs/tiff6.pdf | ||
| |Dependency |https://docs.ogc.org/is/19-008r4/19-008r4.html | ||
| |Dependency |https://docs.ogc.org/is/21-026/21-026.html | ||
| |=== | ||
|
|
||
| // [[GeoTIFF]] OGC 19-008: *OGC GeoTIFF Standard*, Version 1.1, http://docs.opengeospatial.org/is/19-008r4/19-008r4.html | ||
| // [[[TIFF_V6,TIFF V6.0]]], Adobe Developers Association: TIFF Specification Revision 6.0. (1992) https://www.itu.int/itudoc/itu-t/com16/tiff-fx/docs/tiff6.pdf[https://www.itu.int/itudoc/itu-t/com16/tiff-fx/docs/tiff6.pdf] | ||
|
|
||
| ==== Requirements | ||
|
|
||
| [[requirements-class-cog-clause]] | ||
|
|
||
| ===== Cloud Optimized GeoTIFF access | ||
|
|
||
| [[req_cog_http-range]] | ||
| [width="90%",cols="2,6a"] | ||
| |=== | ||
| ^|*Requirement {counter:req-id}* |*/req/cog/http-range* | ||
| ^|A |The coverage resource (`/coverage`), as defined in the Core requirement class, SHALL support HTTP range requests as specified in | ||
| the https://docs.ogc.org/is/21-026/21-026.html#HTTPRangeSupportRequirements[`/req/http-range` requirement class of COG]. | ||
| |=== | ||
|
|
||
| [[req_cog_cloud-optimized]] | ||
| [width="90%",cols="2,6a"] | ||
| |=== | ||
| ^|*Requirement {counter:req-id}* |*/req/cog/cloud-optimized* | ||
| ^|A |The coverage resource, as defined in the Core requirement class, SHALL support content negotiation of a https://docs.ogc.org/is/19-008r4/19-008r4.html[GeoTIFF] using the cloud-optimized profile, | ||
| (`Accept-Profile:`/`Content-Profile:` http://www.opengis.net/def/profile/geotiff/cloud-optimized`, `Accept:`/`Content-Type:` `image/tiff; application=geotiff` media type). | ||
| ^|B |The response SHALL be a GeoTIFF document which validates against the GeoTIFF and TIFF standard. | ||
| ^|C |If the response contains multiple fields, the fields SHALL be encoded as bands ordered following the `x-OGC-property-seq` sequence. | ||
| |=== |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
23 changes: 23 additions & 0 deletions
23
standard/requirements/requirements_class_coveragejson.adoc
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,23 @@ | ||
| [[rc_coveragejson]] | ||
| [cols="1,4",width="90%"] | ||
| |=== | ||
| 2+|*Requirements Class* | ||
| 2+|http://www.opengis.net/spec/ogcapi-coverages-1/1.0/req/coveragejson | ||
| |Target type |Web API | ||
| |Dependency |http://www.opengis.net/spec/ogcapi-coverages-1/1.0/req/core | ||
| |Dependency |https://docs.ogc.org/cs/21-069r2/21-069r2.html | ||
| |=== | ||
|
|
||
| ==== Requirements | ||
|
|
||
| [[requirements-class-coveragejson-clause]] | ||
|
|
||
| ===== Coverage JSON representation | ||
|
|
||
| [[req_coveragejson_coverage]] | ||
| [width="90%",cols="2,6a"] | ||
| |=== | ||
| ^|*Requirement {counter:req-id}* |*/req/coveragejson/coverage* | ||
| ^|A |The coverage resource, as defined in the Core requirement class, SHALL support negotiating a https://docs.ogc.org/cs/21-069r2/21-069r2.html[CoverageJSON] response using the `application/vnd.cov+json` media type. | ||
| ^|B |The response SHALL be a CoverageJSON document which validates against the CoverageJSON community standard. | ||
| |=== |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,86 @@ | ||
| [[rc_geotiff]] | ||
| [cols="1,4",width="90%"] | ||
| |=== | ||
| 2+|*Requirements Class* | ||
| 2+|http://www.opengis.net/spec/ogcapi-coverages-1/1.0/req/geotiff | ||
| |Target type |Web API | ||
| |Dependency |http://www.opengis.net/spec/ogcapi-coverages-1/1.0/req/core | ||
| |Dependency |https://www.itu.int/itudoc/itu-t/com16/tiff-fx/docs/tiff6.pdf | ||
| |Dependency |https://docs.ogc.org/is/19-008r4/19-008r4.html | ||
| |=== | ||
|
|
||
| // [[GeoTIFF]] OGC 19-008: *OGC GeoTIFF Standard*, Version 1.1, http://docs.opengeospatial.org/is/19-008r4/19-008r4.html | ||
| // [[[TIFF_V6,TIFF V6.0]]], Adobe Developers Association: TIFF Specification Revision 6.0. (1992) https://www.itu.int/itudoc/itu-t/com16/tiff-fx/docs/tiff6.pdf[https://www.itu.int/itudoc/itu-t/com16/tiff-fx/docs/tiff6.pdf] | ||
|
|
||
| ==== Requirements | ||
|
|
||
| [[requirements-class-geotiff-clause]] | ||
|
|
||
| ===== GeoTIFF representation | ||
|
|
||
| [[req_geotiff_coverage]] | ||
| [width="90%",cols="2,6a"] | ||
| |=== | ||
| ^|*Requirement {counter:req-id}* |*/req/geotiff/coverage* | ||
| ^|A |The coverage resource, as defined in the Core requirement class, SHALL support negotiating a https://docs.ogc.org/is/19-008r4/19-008r4.html[GeoTIFF] response using the `image/tiff; application=geotiff` media type. | ||
| ^|B |The response SHALL be a GeoTIFF document which validates against the GeoTIFF and TIFF standard. | ||
| ^|C |If the response contains multiple fields, the fields SHALL be encoded as bands ordered following the `x-OGC-property-seq` sequence. | ||
| |=== | ||
|
|
||
| ===== GeoTIFF parameters | ||
|
|
||
| [[rec_geotiff_compression]] | ||
| [width="90%",cols="2,6a"] | ||
| |=== | ||
| ^|*Recommendation {counter:rec-id}* |*/rec/geotiff/compression* | ||
| ^|A |The coverage resource SHOULD support a `compression` parameter. | ||
| ^|B |The possible values for the `compression` parameter SHOULD be `none`, `packbits`, `huffman`, `lzw`, `deflate`. | ||
| ^|C |The GeoTIFF coverage response SHOULD use the compression method specified. | ||
| |=== | ||
|
|
||
| [[rec_geotiff_predictor]] | ||
| [width="90%",cols="2,6a"] | ||
| |=== | ||
| ^|*Recommendation {counter:rec-id}* |*/rec/geotiff/predictor* | ||
| ^|A |The coverage resource SHOULD support a `predictor` parameter. | ||
| ^|B |The possible values for the `compression` parameter SHOULD be `none`, `horizontal`, `floating-point`. | ||
| ^|C |The GeoTIFF coverage response SHOULD use the predictor specified. | ||
| |=== | ||
|
|
||
| [[rec_geotiff_interleave]] | ||
| [width="90%",cols="2,6a"] | ||
| |=== | ||
| ^|*Recommendation {counter:rec-id}* |*/rec/geotiff/interleave* | ||
| ^|A |The coverage resource SHOULD support a `interleave` parameter. | ||
| ^|B |The possible values for the `interleave` parameter SHOULD be `pixel` (PlanarConfiguration value 1 for chunky, PLANARCONFIG_CONTIG in libtiff) and `band` | ||
| (PlanarConfiguration value 2 for planar configuration, PLANARCONFIG_SEPARATE in libtiff). | ||
| ^|C |The GeoTIFF coverage response SHOULD use the interleave setting specified (corresponding to the PlanarConfiguration in TIFF terminology). | ||
| |=== | ||
|
|
||
| [[rec_geotiff_tiling]] | ||
| [width="90%",cols="2,6a"] | ||
| |=== | ||
| ^|*Recommendation {counter:rec-id}* |*/rec/geotiff/tiling* | ||
| ^|A |The coverage resource SHOULD support a boolean `tiling` parameter. | ||
| ^|B |The GeoTIFF coverage response SHOULD use tiling if `tiling` is true, or strips otherwise. | ||
| |=== | ||
|
|
||
| [[rec_geotiff_tile-height-width]] | ||
| [width="90%",cols="2,6a"] | ||
| |=== | ||
| ^|*Recommendation {counter:rec-id}* |*/rec/geotiff/tile-width-height* | ||
| ^|A |The coverage resource SHOULD support integer multiple of 16 `tile-width` and `tile-height` parameters when a `tiling` parameter is used. | ||
| ^|B |The Implementation SHOULD return an error if these parameters are provided without a `tiling` parameter, or if their value is not a multiple of 16 greater than 0. | ||
| ^|C |The GeoTIFF coverage response SHOULD use these tile width and tile height (TileLength in TIFF terminology). | ||
| |=== | ||
|
|
||
| [[rec_geotiff_overview-count]] | ||
| [width="90%",cols="2,6a"] | ||
| |=== | ||
| ^|*Recommendation {counter:rec-id}* |*/rec/geotiff/overview-count* | ||
| ^|A |The coverage resource SHOULD support a integer `overview-count`. | ||
| ^|B |The Implementation SHOULD return an error if this parameter is smaller than 0. | ||
| ^|C |The GeoTIFF coverage response SHOULD generate progressively smaller overviews based on that requested number of overviews. | ||
| |=== | ||
|
|
||
| NOTE: Clients can use a combination of `tiling`, `tile-width`, `tile-height` and `overview-count` to get a GeoTIFF conforming to the https://docs.ogc.org/is/21-026/21-026.html[OGC Cloud Optimize GeoTIFF] standard. |
Empty file.
Empty file.
Empty file.
Empty file.
Empty file.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,35 @@ | ||
| [[rc_png]] | ||
| [cols="1,4",width="90%"] | ||
| |=== | ||
| 2+|*Requirements Class* | ||
| 2+|http://www.opengis.net/spec/ogcapi-coverages-1/1.0/req/geotiff | ||
| |Target type |Web API | ||
| |Dependency |http://www.opengis.net/spec/ogcapi-coverages-1/1.0/req/core | ||
| |Dependency |https://www.w3.org/TR/png/ | ||
| |=== | ||
|
|
||
| ==== Requirements | ||
|
|
||
| [[requirements-class-png-clause]] | ||
|
|
||
| ===== PNG representation | ||
|
|
||
| [[req_png_coverage]] | ||
| [width="90%",cols="2,6a"] | ||
| |=== | ||
| ^|*Requirement {counter:req-id}* |*/req/png/coverage* | ||
| ^|A |The coverage resource, as defined in the Core requirement class, SHALL support negotiating a https://www.w3.org/TR/png/[PNG] response using the `image/png` media type. | ||
| ^|B |The PNG response SHALL use 16-bit values for fields requiring more than 8-bit to encode accurately. | ||
| ^|C |The Implementation SHALL return a 400 error for requests for any number of fields other than 1 or 3. | ||
| ^|D |If the response contains multiple fields, the fields SHALL be encoded as bands ordered following the `x-OGC-property-seq` sequence. | ||
| ^|E | A `Values-Scale:` response header with a numeric real value SHALL be returned indicating the factor by which values were multiplied before an offset was added to result in the encoded 8-bit or 16-bit PNG unsigned integer values. | ||
| ^|F | A `Values-Offset:` response header with a numeric real value SHALL be returned indicating the offset which was added after multiplying values by the scale factor to result in the encoded 8-bit or 16-bit PNG unsigned integer values. | ||
| |=== | ||
|
|
||
| [[rec_png_scale_offset]] | ||
| [width="90%",cols="2,6a"] | ||
| |=== | ||
| ^|*Recommendation {counter:rec-id}* |*/rec/png/scale-offset* | ||
| ^|A |The Implementation SHOULD support a `values-scale` query parameter on coverage resources when requesting a PNG output to indicate the value scale factor, as described in the `Values-Scale:` response header part of the content requirement. | ||
| ^|B |The Implementation SHOULD support a `values-offset` query parameter on coverage resources when requesting a PNG output to indicate the value offset, as described in the `Values-Offset:` response header part of the content requirement. | ||
| |=== |
Empty file.