EOX GitLab Instance

Skip to content
Snippets Groups Projects
Commit f71c264c authored by Stephan's avatar Stephan
Browse files

Further work mostly on viewing section.

parent 04561fda
No related branches found
No related tags found
No related merge requests found
Hide whitespace changes
Inline Side-by-side
documentation/usage-guide/downloading.rst
+ 9
− 2
View file @ f71c264c
......@@ -3,6 +3,13 @@
Downloading
===========
WCS
DSEO
`Web Coverage Service (WCS) <https://www.ogc.org/standards/wcs>`_
`Download Service for Earth Observation Products Best Practice <https://portal.opengeospatial.org/files/?artifact_id=55210>`_
TODO
WCS
DSEO
The final chapter :ref:`sample_requests` holds a list of sample requests against
the various services described in this usage guide.
documentation/usage-guide/intro.rst
+ 1
− 1
View file @ f71c264c
......@@ -5,7 +5,7 @@ This is the Usage Guide of the View Server (VS). The intended readers are users
of the web client shown below and external services provided by the View Server.
These provided external services are services for searching, viewing, and
downloading of Earth Observation (EO) data. Services endpoints optimized for
downloading of Earth Observation (EO) data. Service endpoints optimized for
performance as well as for flexibility are provided alongside each other.
.. figure:: images/webclient_start.*
......
documentation/usage-guide/sample-requests.rst
+ 6
− 4
View file @ f71c264c
......@@ -26,15 +26,17 @@ Cache
WMTS
^^^^
* `Capabilities <https://vhr18.pdas.prism.eox.at/cache/ows/wmts/1.0.0/WMTSCapabilities.xml>`_
* `WMTS Capabilities <https://vhr18.pdas.prism.eox.at/cache/ows/wmts/1.0.0/WMTSCapabilities.xml>`_
* `True color tile <https://vhr18.pdas.prism.eox.at/cache/ows/wmts/1.0.0/VHR_IMAGE_2018_Level_3__TRUE_COLOR/default/2018-06-01T00%3A00%3A00Z--2018-07-01T00%3A00%3A00Z/WGS84/11/524/2224.xxx>`_
* `False color tile <https://vhr18.pdas.prism.eox.at/cache/ows/wmts/1.0.0/VHR_IMAGE_2018_Level_3__FALSE_COLOR/default/2018-06-01T00%3A00%3A00Z--2018-07-01T00%3A00%3A00Z/WGS84/11/524/2224.xxx>`_
* `NDVI tile <https://vhr18.pdas.prism.eox.at/cache/ows/wmts/1.0.0/VHR_IMAGE_2018_Level_3__NDVI/default/2018-06-01T00%3A00%3A00Z--2018-07-01T00%3A00%3A00Z/WGS84/11/524/2224.xxx>`_
TODO: full layers
WMS
^^^
* `Capabilities <https://vhr18.pdas.prism.eox.at/cache/ows?service=wms&request=getcapabilities>`_
* `WMS Capabilities <https://vhr18.pdas.prism.eox.at/cache/ows?service=wms&request=getcapabilities>`_
* `True color image <https://vhr18.pdas.prism.eox.at/cache/ows?SERVICE=WMS&VERSION=1.1.0&REQUEST=GetMap&FORMAT=image%2Fpng&TRANSPARENT=true&LAYERS=VHR_IMAGE_2018_Level_3__TRUE_COLOR&STYLES=&time=2018-06-01T00%3A00%3A00Z%2F2018-07-01T00%3A00%3A00Z&WIDTH=256&HEIGHT=256&SRS=EPSG%3A4326&BBOX=15.46875%2C43.857421875%2C15.556640625%2C43.9453125>`_
Renderer
......@@ -53,7 +55,7 @@ WMS
^^^
* `Collection layers capabilities <https://vhr18.pdas.prism.eox.at/ows?service=wms&request=getcapabilities>`_
* `Layer capabilities for one product <https://vhr18.pdas.prism.eox.at/ows?service=wms&request=GetCapabilities&cql=identifier='urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7'>`_
* `Layer capabilities for one product <https://vhr18.pdas.prism.eox.at/ows?service=wms&request=GetCapabilities&cql=identifier=%27urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7%27>`_
* `Quicklook <https://vhr18.pdas.prism.eox.at/ows?service=WMS&version=1.3.0&request=GetMap&layers=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7&format=image/png&TRANSPARENT=true&width=463&height=500&CRS=EPSG:4326&STYLES=&BBOX=47.297788,25.978201,47.372606,26.047511>`_
* `False color <https://vhr18.pdas.prism.eox.at/ows?service=WMS&version=1.3.0&request=GetMap&layers=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__FALSE_COLOR&format=image/png&TRANSPARENT=true&width=463&height=500&CRS=EPSG:4326&STYLES=&BBOX=47.297788,25.978201,47.372606,26.047511>`_
* `NDVI including style <https://vhr18.pdas.prism.eox.at/ows?service=WMS&version=1.3.0&request=GetMap&layers=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__NDVI&format=image/png&TRANSPARENT=true&width=463&height=500&CRS=EPSG:4326&STYLES=coolwarm&BBOX=47.297788,25.978201,47.372606,26.047511>`_
......@@ -65,7 +67,7 @@ WMS
WCS
^^^
* `Capabilities <https://vhr18.pdas.prism.eox.at/ows?service=wcs&request=getcapabilities>`_
* `WCS Capabilities <https://vhr18.pdas.prism.eox.at/ows?service=wcs&request=getcapabilities>`_
* `Coverage set description <https://vhr18.pdas.prism.eox.at/ows?service=WCS&version=2.0.1&request=DescribeEOCoverageSet&eoId=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7>`_
* `Coverage description <https://vhr18.pdas.prism.eox.at/ows?service=WCS&version=2.0.1&request=DescribeCoverage&coverageId=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__coverage>`_
* `Full in default configuration <https://vhr18.pdas.prism.eox.at/ows?service=WCS&version=2.0.1&request=GetCoverage&coverageId=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__coverage>`_
......
documentation/usage-guide/searching.rst
+ 215
− 65
View file @ f71c264c
......@@ -3,90 +3,240 @@
Searching
=========
The main interface for searching is provided by OpenSearch using various
extensions.
TODO add links to spec
The main interface for searching is provided by `OpenSearch
<http://opensearch.org/>`_ using various extensions including the `Geo and Time
Extensions <https://portal.opengeospatial.org/files/?artifact_id=56866>`_, the
`Extension for Earth Observation
<http://docs.opengeospatial.org/is/13-026r8/13-026r8.html>`_ as well as the
`CEOS OpenSearch Best Practice Document
<http://ceos.org/document_management/Working_Groups/WGISS/Interest_Groups/OpenSearch/CEOS-OPENSEARCH-BP-V1.2.pdf>`_.
The OpenSearch URL endpoints are:
* `/opensearch`: Main service description
* `/opensearch/<format>`: Search for collections in a specific format
* `/opensearch/collections/<collection-id>`: Collection specific description
* `/opensearch/collections/<collection-id>/<format>`: Search for products in
* ``/opensearch``: Main service description
* ``/opensearch/<format>``: Search for collections in a specific format
* ``/opensearch/collections/<collection-id>``: Collection specific description
* ``/opensearch/collections/<collection-id>/<format>``: Search for products in
a collection in that format
The description related entrypoints provide an OpenSearch Description Document
Responses
---------
The description related endpoints provide an OpenSearch Description Document
(OSDD). This XML based file format describes general service metadata and
various access URLs.
various access URL templates.
These URL objects provide templates that can be filled with
parameters to submit actual metadata queries. Depending on the used
URL, the search result is returned in one of the following formats:
These URL objects provide templates that can be filled with parameters to submit
actual metadata queries. Depending on the used URL, the search result is
returned in one of the following formats:
* `atom`: Atom syndication format
* `rss`: RSS
* `kml`: Keyhole Markup Language
* `json`: GeoJSON
* ``atom``: Atom syndication format
* ``rss``: RSS
* ``html``: HTML
* ``kml``: Keyhole Markup Language
* ``json``: GeoJSON
The resulting items in that result document can be paged. Specific
pages can be retrieved using the `offset` and `count` parameters.
Additionally, the response contains links to the first, last, next,
and previous pages of the result set.
The resulting items in that result document can be paged. Specific pages can be
retrieved using the ``offset`` and ``count`` parameters. Additionally, the
response contains links to the first, last, next, and previous pages of the
result set.
The results of the search depend on the type of object being searched.
For the collection search, the result items are collection descriptions
of all matched collections encoded in the selected format. Each
description contains a link to its own specific OSDD document.
The results of the search depend on the type of object being searched. For the
collection search, the result items are collection descriptions of all matched
collections encoded in the selected format. Each description contains a link to
its own specific OSDD document.
In product searches, the result document items are descriptions of
products, containing links to thumbnails, browses and product specific
services such as WMS or WCS. Additionally it contains the products
acquisition footprint and timestamp.
In product searches, the result document items are descriptions of products,
containing links to thumbnails, browses, and product specific services such as
WMS or WCS. Additionally it contains the products acquisition footprint and
time stamp.
Filters
-------
The URL templates for both the collection and the record search allow
to pass parameters that control the query and shape of the search.
The following table shows all parameters available for both collection
and product search:
The URL templates for both the collection and the record search allow to pass
parameters that control the query and shape of the search. The following table
shows all parameters available for both collection and product searches:
============= =================================================================
Parameter Description
============= =================================================================
startIndex | The index offset of the items. Used to get subsets of a result
=============== ================================================================
Parameter Description
=============== ================================================================
``startIndex`` The index offset of the items. Used to get subsets of a result
set
count | The number of records for each page
start | The start timestamp for the time range
end | The end timestamp for the time range
timerel | The semantic of the time range. Either `intersects`,
`contains`, `disjoint`, or `equals`
bbox | The geographic bounding box expressed as `min-lon`, `min-lat`,
`max-lon`, `max-lat` in WGS 84
geom | A WKT encoded geometry for a geographic search
lon | The longitude component of point/radius searches
lat | The latitude component of point/radius searches
r | The radious in metres of point/radius searches
georel | The semantic of the geometry filter. One of `intersects`,
`contains`, or `disjoint`
============= =================================================================
The following parameters are only available in collection searches in
addition to the general search parameters:
============= =================================================================
Parameter Description
============= =================================================================
============= =================================================================
``count`` The number of records for each page
``start`` The start time stamp for the time range
``end`` The end time stamp for the time range
``timerel`` The semantic of the time range. Either ``intersects``,
``contains``, ``disjoint``, or ``equals``
``bbox`` The geographic bounding box expressed as ``min-lon``,
``min-lat``, ``max-lon``, ``max-lat`` in WGS84 coordinates
``geom`` A WKT encoded geometry for a geographic search
``lon`` The longitude component of point/radius searches
``lat`` The latitude component of point/radius searches
``r`` The radious in metres of point/radius searches
``georel`` The semantic of the geometry filter. One of ``intersects``,
``contains``, or ``disjoint``
=============== ================================================================
The following parameters are only available in product searches in
addition to the general search parameters:
============= =================================================================
Parameter | Description
============= =================================================================
cloudCover | Cloud cover filter. Either a specific value or an interval of
=============== ================================================================
Parameter Description
=============== ================================================================
``uid`` Filter on identifiert
``cloudCover`` Cloud cover filter. Either a specific value or an interval of
values. Values between 0-100
============= =================================================================
=============== ================================================================
The available parameters depend on the configuration made by the operator.
Example response
----------------
Below is a sample response from a product search for an individual product in
Atom format.
.. code-block:: xml
<feed xmlns:cql="http://a9.com/-/opensearch/extensions/cql/1.0/" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:eo="http://a9.com/-/opensearch/extensions/eo/1.0/" xmlns:geo="http://a9.com/-/opensearch/extensions/geo/1.0/" xmlns:georss="http://www.georss.org/georss" xmlns:media="http://search.yahoo.com/mrss/" xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/" xmlns:owc="http://www.opengis.net/owc/1.0" xmlns:time="http://a9.com/-/opensearch/extensions/time/1.0/" xmlns="http://www.w3.org/2005/Atom">
<id>https://vhr18.pdas.prism.eox.at/opensearch/collections/VHR_IMAGE_2018_Level_3/atom/?uid=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7</id>
<title>VHR_IMAGE_2018_Level_3 Search</title>
<description/>
<opensearch:totalResults>1</opensearch:totalResults>
<opensearch:startIndex>0</opensearch:startIndex>
<opensearch:itemsPerPage>1</opensearch:itemsPerPage>
<opensearch:Query geo:uid="urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7" role="request"/>
<link href="https://vhr18.pdas.prism.eox.at/opensearch/" type="application/opensearchdescription+xml" rel="search"/>
<link href="https://vhr18.pdas.prism.eox.at/opensearch/collections/VHR_IMAGE_2018_Level_3/atom/?uid=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7" type="application/atom+xml" rel="self"/>
<link href="https://vhr18.pdas.prism.eox.at/opensearch/collections/VHR_IMAGE_2018_Level_3/atom/?uid=urn%3Aeop%3ADOVE%3AMULTISPECTRAL_4m%3A20180811_081455_1054_3be7" type="application/atom+xml" rel="first"/>
<link href="https://vhr18.pdas.prism.eox.at/opensearch/collections/VHR_IMAGE_2018_Level_3/atom/?startIndex=0&amp;uid=urn%3Aeop%3ADOVE%3AMULTISPECTRAL_4m%3A20180811_081455_1054_3be7" type="application/atom+xml" rel="last"/>
<entry>
<title>urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7</title>
<id>https://vhr18.pdas.prism.eox.at/opensearch/collections/VHR_IMAGE_2018_Level_3/atom/?uid=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7</id>
<dc:identifier>urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7</dc:identifier>
<dc:date>2018-08-11T08:14:55Z</dc:date>
<georss:box>47.297788 25.978201 47.372606 26.047511</georss:box>
<georss:where>
<gml:MultiSurface xmlns:eop="http://www.opengis.net/eop/2.0" xmlns:gml="http://www.opengis.net/gml/3.2" xmlns:gmlcov="http://www.opengis.net/gmlcov/1.0" xmlns:om="http://www.opengis.net/om/2.0" srsName="EPSG:4326" gml:id="multisurface_urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7">
<gml:surfaceMember>
<gml:Polygon gml:id="polygon_urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7_1">
<gml:exterior>
<gml:LinearRing>
<gml:posList>47.29778796 26.00330821 47.29784395 26.00300545 47.29852855 26.00098039 47.33176050 25.98961353 47.35564999 25.98157482 47.35572189 25.98204011 47.36693204 25.97820059 47.37260630 26.01455420 47.37197192 26.01658883 47.37098788 26.01863079 47.36976416 26.02036682 47.36834411 26.02173541 47.36677806 26.02268812 47.31293985 26.04698765 47.31114307 26.04751063 47.30931486 26.04748521 47.30753117 26.04691252 47.30586607 26.04581637 47.30438870 26.04424235 47.30409927 26.04377423 47.29778796 26.00330821</gml:posList>
</gml:LinearRing>
</gml:exterior>
</gml:Polygon>
</gml:surfaceMember>
</gml:MultiSurface>
</georss:where>
<link href="https://vhr18.pdas.prism.eox.at/ows?service=DSEO&amp;version=1.0.0&amp;request=GetProduct&amp;ProductURI=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7" rel="enclosure"/>
<media:content url="https://vhr18.pdas.prism.eox.at/ows?service=WMS&amp;version=1.3.0&amp;request=GetMap&amp;layers=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7&amp;format=image/png&amp;TRANSPARENT=true&amp;width=463&amp;height=500&amp;CRS=EPSG:4326&amp;STYLES=&amp;BBOX=47.297788,25.978201,47.372606,26.047511">
<media:category>QUICKLOOK</media:category>
</media:content>
<media:content url="https://vhr18.pdas.prism.eox.at/ows?service=WMS&amp;version=1.3.0&amp;request=GetMap&amp;layers=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7&amp;format=image/png&amp;TRANSPARENT=true&amp;width=92&amp;height=100&amp;CRS=EPSG:4326&amp;STYLES=&amp;BBOX=47.297788,25.978201,47.372606,26.047511">
<media:category>THUMBNAIL</media:category>
</media:content>
<owc:offering code="http://www.opengis.net/spec/owc-atom/1.0/req/wms">
<owc:operation href="https://vhr18.pdas.prism.eox.at/ows?service=WMS&amp;request=GetCapabilities&amp;cql=identifier='urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7'" code="GetCapabilities" type="application/xml" method="GET"/>
<owc:operation href="https://vhr18.pdas.prism.eox.at/ows?service=WMS&amp;version=1.3.0&amp;request=GetMap&amp;layers=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7&amp;format=image/png&amp;TRANSPARENT=true&amp;width=463&amp;height=500&amp;CRS=EPSG:4326&amp;STYLES=&amp;BBOX=47.297788,25.978201,47.372606,26.047511" code="GetMap" type="image/png" method="GET"/>
</owc:offering>
<owc:offering code="http://www.opengis.net/spec/owc-atom/1.0/req/wcs">
<owc:operation href="https://vhr18.pdas.prism.eox.at/ows?service=WCS&amp;version=2.0.1&amp;request=GetCapabilities" code="GetCapabilities" type="application/xml" method="GET"/>
<owc:operation href="https://vhr18.pdas.prism.eox.at/ows?service=WCS&amp;version=2.0.1&amp;request=DescribeCoverage&amp;coverageId=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__coverage" code="DescribeCoverage" type="application/xml" method="GET"/>
<owc:operation href="https://vhr18.pdas.prism.eox.at/ows?service=WCS&amp;version=2.0.1&amp;request=GetCoverage&amp;coverageId=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__coverage" code="GetCoverage" type="image/tiff" method="GET"/>
</owc:offering>
<summary type="html"><![CDATA[<table>
<tr>
<td valign="top" width="10%">
<a href="https://vhr18.pdas.prism.eox.at/ows?service=WMS&amp;version=1.3.0&amp;request=GetMap&amp;layers=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7&amp;format=image/png&amp;TRANSPARENT=true&amp;width=463&amp;height=500&amp;CRS=EPSG:4326&amp;STYLES=&amp;BBOX=47.297788,25.978201,47.372606,26.047511" target="_blank" title="View quicklook image">
<img align="left" border="0" hspace="8" src="https://vhr18.pdas.prism.eox.at/ows?service=WMS&amp;version=1.3.0&amp;request=GetMap&amp;layers=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7&amp;format=image/png&amp;TRANSPARENT=true&amp;width=92&amp;height=100&amp;CRS=EPSG:4326&amp;STYLES=&amp;BBOX=47.297788,25.978201,47.372606,26.047511" />
</a>
</td>
<td valign="top" width="90%">
<table>
<tr valign="top">
<td>
<b>Date </b>
</td>
<td>2018-08-11T08:14:55+00:00 / 2018-08-11T08:14:55+00:00</td>
</tr>
<tr valign="top">
<td>
<b>Metadata</b>
</td>
<td>
<a href="https://vhr18.pdas.prism.eox.at/opensearch/collections/VHR_IMAGE_2018_Level_3/atom/?uid=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7" title="Atom format" target="_blank">ATOM</a>
</td>
</tr>
<tr valign="top">
<td>
<b>Download</b>
</td>
<td>
<a href="https://vhr18.pdas.prism.eox.at/ows?service=DSEO&amp;version=1.0.0&amp;request=GetProduct&amp;ProductURI=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7" title="Download" target="_blank">Package</a>
</td>
</tr>
</table>
</td>
</tr>
</table>
<h3>OGC cross links</h3>
<ul>
<li>
<b>WMS</b>
<ul>
<li>
<a href="https://vhr18.pdas.prism.eox.at/ows?service=WMS&amp;request=GetCapabilities&amp;cql=identifier=&#39;urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7&#39;" target="_blank">GetCapabilities</a>
</li>
</ul>
<ul>
<li>
<a href="https://vhr18.pdas.prism.eox.at/ows?service=WMS&amp;version=1.3.0&amp;request=GetMap&amp;layers=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7&amp;format=image/png&amp;TRANSPARENT=true&amp;width=463&amp;height=500&amp;CRS=EPSG:4326&amp;STYLES=&amp;BBOX=47.297788,25.978201,47.372606,26.047511" target="_blank">GetMap</a>
</li>
</ul>
</li>
<li>
<b>WCS</b>
<ul>
<li>
<a href="https://vhr18.pdas.prism.eox.at/ows?service=WCS&amp;version=2.0.1&amp;request=DescribeEOCoverageSet&amp;eoId=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7" target="_blank">DescribeEOCoverageSet</a>
</li>
<li>
<b>urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__coverage</b>
<ul>
<li>
<a href="https://vhr18.pdas.prism.eox.at/ows?service=WCS&amp;version=2.0.1&amp;request=DescribeCoverage&amp;coverageId=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__coverage" target="_blank">DescribeCoverage</a>
</li>
<li>
<a href="https://vhr18.pdas.prism.eox.at/ows?service=WCS&amp;version=2.0.1&amp;request=GetCoverage&amp;coverageId=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__coverage" target="_blank">GetCoverage</a>
</li>
</ul>
</li>
</ul>
</li>
</ul>
<h3>Metadata</h3>
<table>
<tr>
<td>Cloud Cover</td>
<td>0.0</td>
</tr>
</table>]]></summary>
</entry>
</feed>
Continue reading about the provided :ref:`viewing` services.
documentation/usage-guide/viewing.rst
+ 96
− 2
View file @ f71c264c
......@@ -3,6 +3,100 @@
Viewing
=======
/cache endpoint for most performing requests fixed to predefined layers
The viewing interface is implemented following the `Web Map Tile Service (WMTS)
<https://www.ogc.org/standards/wmts>`_ as well as the `Web Map Service (WMS)
<https://www.ogc.org/standards/wms>`_ . Both services are implemented by a wide
range of client software which makes it as simple as possible to integrate the
viewing service as needed.
/ows endpoint for flexible requests e.g. customize stretch
Service endpoints optimized for performance as well as for flexibility are
provided alongside each other.
Performance optimized service
-----------------------------
The performance optimized service variant is provided under the path
``/cache/ows?``.
This endpoint offers access to predefined visualizations via WMTS and WMS. The
GetTile as well as GetMap requests are answered from image tiles cached on
object storage when possible. :numref:`fig_wmts_tiles` below shows the three
predefined visualizations, true color, false color, and NDVI of the same image
tile.
.. _fig_wmts_tiles:
.. figure:: images/wmts_tiles.*
:alt: WMTS Tiles - True color, false color, and NDVI
*WMTS Tiles - True color, false color, and NDVI*
Image tiles not yet present in the cache are stored upon first hit for
consecutive requests. This is the so-called on-demand caching. The operator
might decide for optimal performance, even for the first request, to pre-seed
the cache. Also a mixed variant with a partly pre-seeded cache for example up to
a certain zoom level is possible.
However, this is done fully transparent to the users and the only impact is that
they might need to wait slightly longer when they are the first to visualize a
certain product.
This service offers access on collection level only. Individual products can be
addressed using the ``time`` parameter given that they do not cover one another
on the time axis.
The best performance is offered at the WMTS interface which serves images tiles
as they are cached without the need of any reprocessing. WMS responses are
generated on-the-fly from image tiles and might thus need some reprocessing to
stitch together and scale image tiles.
TODO: full layers
More sophisticated reprocessing like reprojection or custom color adjustments
are not offered at this endpoint.
Flexible service
----------------
The other service variant offered is optimized for the best possible flexibility
and can be accessed at the path ``/ows?``.
This endpoint offers the following customizations via WMS:
* Access to individual products via ID (``cql=identifier='ID'``)
* Access to entire collections/datasets supporting ``time`` parameter
* Various layers as defined by the `Earth Observation Application Profile of WMS
<https://portal.opengeospatial.org/files/?artifact_id=30912>`_ like one
showing outlines of products (``__outlines``)
* Additional useful layers like one showing both, products and outlines,
correctly rendering topology of outlines (``__outlined``) or one showing a
validity mask (``__validity``) or applied validity mask
(``___masked_validity``)
* Numerous styles for layer where feasible like outlines or NDVI
(``layers=ID__NDVI&STYLES=coolwarm``)
* Reprojection to operator configured coordinate reference systems
* Color adjustment via custom linear stretch ``dim_range=<low-red-or-grey>
<high-red-or-grey>[,<low-green> <high-green>,<low-blue> <high-blue>]``
* Filtering of products to render into collection/dataset visualizations via
Common Query Language (CQL) for example ``&cql=cloudCover<1``
* All other standard WMS parameters like ``transparent``, ``format``, etc.
All these customization parameters can of course be combined as needed.
Loading in QGIS
---------------
.. _fig_wms_qgis1:
.. figure:: images/wms_qgis1.*
:alt: WMS loading in QGIS
*WMS loading in QGIS*
.. _fig_wms_qgis2:
.. figure:: images/wms_qgis2.*
:alt: WMS loading in QGIS
*WMS loading in QGIS*
Continue reading about the provided :ref:`downloading` services.
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment