Product Admin Menu

1 OpenSearch and WCS2.x APIs

1.1 Server address

https://edav-das.dev.esa-maap.org/

1.2 Available Collections

1.3 OpenSearch

The pycsw catalogue supports both OpenSearch and CSW interfaces; it is used as OpenSearch catalogue since it is compliant with other catalogue services in ESA.

1.3.1 GetCapabilities request

https://edav-das.dev.esa-maap.org/pycsw/csw.py?service=CSW&version=3.0.0&request=GetCapabilities

1.3.2 Record query

Generic query syntax

https://edav-das.dev.esa-maap.org/pycsw/csw.py?mode=opensearch&service=CSW&version=2.0.2&request=GetRecords&elementsetname=full&typenames=csw:Record&resulttype=results&q={searchTerms?}&bbox={geo:box?}&time={time:start?}/{time:end?}&startposition={startIndex?}&maxrecords={count?}

Example query

https://edav-das.dev.esa-maap.org/pycsw/csw.py?service=CSW&version=3.0.0&request=GetRecords&elementsetname=full&typenames=csw:Record&resulttype=results

1.4 WCS2.0

1.4.1 GetCapabilities

to obtain a list of available collections

https://edav-das.dev.esa-maap.org/wcs?service=WCS&Request=GetCapabilities&version=2.0.0

1.4.2 DescribeCoverage

to obtain all information for a specific collection

https://edav-das.dev.esa-maap.org/wcs?service=WCS&Request=DescribeCoverage&version=2.0.0&coverageID=<CoverageID>

Example

https://edav-das.dev.esa-maap.org/wcs?service=WCS&Request=DescribeCoverage&version=2.0.0&coverageId=uavsar_AfriSAR_v1_SLC

1.4.3 GetCoverage

To extract data in different formats from the available collections

https://edav-das.dev.esa-maap.org/wcs?service=WCS&Request=GetCoverage&version=2.0.0&coverageID=<CoverageID>&subset=[Long][N](min,max)&subset=[Lat][E](min,max)&subset=t(minDate,maxDate)&format=<#####>&colortable=<ID>&scale=<nn>&size=<output raster size>

Where

• Spatial subsettings values depend on the dataset (see DescribeCoverage output axisLabels).
  • If <axisLabels>Long Lat t</axisLabels> then latitude and longitude values in degrees must be provided
  • If <axisLabels>N E t</axisLabels> then North and East values in meters shall be provided
• Time subsetting
  • Dates / times can be provided in ansi or unix time (see examples below)
• format=<##>
  • image/tiff
  • image/png
  • image/jp2
  • image/envi
  • "text/plain
  • application/xml
  • application/gml+xml
  • application/tar
• colortable=<ID>
  • ID =https://www.ncl.ucar.edu/Document/Graphics/color_table_gallery.shtml
• colorrange=<min,max>
  • the values are taken between the two values
• scale=<nn>
  • nn is resampling factor (full resolution, 0.1 resolution degraded of a factor of 10).
• size=<x,y>
  • output raster size

Further the GFIX parameters

• subset=GFIX(param1, param2, …)

Examples.

Average image for a specific time in png format

https://edav-das.dev.esa-maap.org/wcs?service=WCS&Request=GetCoverage&version=2.0.0&coverageId=uavsar_AfriSAR_v1_SLC&subset=t(1456358400)&format=image/png&scale=0.1

Use of the GFIX parameter

The following tables represent the coding of the GFIX parameters

https://edav-das.dev.esa-maap.org/wcs?service=WCS&Request=GetCoverage&version=2.0.0&coverageId=uavsar_AfriSAR_v1_SLC&format=image/png&scale=0.1&subset=gfix(14043,16008)

Subset (bounding box)

https://edav-das.dev.esa-maap.org/wcs?service=WCS&Request=GetCoverage&version=2.0.0&coverageId=uavsar_AfriSAR_v1_SLC&format=image/png&subset=gfix(14043,16008)&subset=Lat(-0.2,-0.1)&subset=Long(11.5,11.7)

Time series over a single point

https://edav-das.dev.esa-maap.org/wcs?service=WCS&Request=GetCoverage&version=2.0.0&coverageId=uavsar_AfriSAR_v1_SLC&format=application/json&subset=gfix(14043)&subset=Lat(-0.15)&subset=Long(11.6)

Data From Polygon

Pres-requisites: open a linux terminal

wget -O Afrisar_lopenp_20160225.png --post-data='geometry= POLYGON ((11.591896804755 -0.157816430402596,11.6847843973044 -0.133991801013367,11.6907981530032 -0.208241383062162,11.5892089031614 -0.233710672032188,11.591896804755 -0.157816430402596)) ' 'https://edav-das.dev.esa-maap.org/wcs?service=WCS&Request=GetCoverage&version=2.0.0&coverageId=uavsar_AfriSAR_v1_SLC&format=image/png&subset=gfix(14043,16008)'