WCS GetCoverage Query

From Earth Science Information Partners (ESIP)

< Back to Glossary | Edit with Form

WCS_GetCoverage_Query Description: [[TermDesc::This is the main data query for a WCS service. The request contains Coverage identifier, Geographical BoundingBox and optionally, TimeSequence, fields, and filters for fields. The Coverage Processor for Cubes or Points processes the query and produces data returned to the client.]]

Glossary Domain: WCS

Related Links

Links to this page
[[Links::Coverage Processor for Cubes Coverage Processor for Points]]

Contributors

No Contributors

History

No History Available

Term Details


Dissecting a WCS Query

Address, port and provider

   http://128.252.202.19:8080/CIRA?

Identifying service, version and request

   Service=WCS
   Version=1.1.2
   Request=GetCoverage

Identifying the coverage. Multiple coverages are not allowed.

   Identifier=VIEWS

Restricting boundingbox. Longitude range is -100..-90 and latitude range is 30..40

   BoundingBox=-100,30,-90,40,urn:ogc:def:crs:OGC:2:84

Selecting time. from 2008-07-02 to 2008-07-08 every three days: 2008-07-02, 2008-07-05, 2008-07-08

   TimeSequence=2008-07-02/2008-07-08/P3D

Selecting field SO4f only.

   RangeSubset=SO4f

Want text/csv

   Format=text/csv

Store the CSV file into the server and return only XML envelope with a pointer to it.

   Store=true

Live Query: VIEWS Map slice for SO4f

With

   Store=false

the service returns both XML Envelope and the CSV table in one [1] document. Unfortunately, all the browsers cannot handle it, firefox being tested as the only working client.

Live Query: VIEWS Map slice for SO4f with store=false

Filtering by Location Dimension loc_code

RangeSubset=SO4f[location[YOSE1]] selects field SO4f filtering by dimension location by loc_code=YOSE1.

Live Query: VIEWS Map slice for SO4f[location[YOSE1;GRSM1]]

Examples:

Timeseries for one location. RangeSubset both selects fields and filters them by dimensions.

RangeSubset=BEXT[location[13935]] selects field BEXT filtering by dimension location by loc_code=13935.

The parameter store=true makes the return to be an xml document containing some meta information and a url to the CSV result. You need to copy the url from the XML envelope and paste it to address bar to retrieve it yourself.

http://128.252.202.19:8080/NCDC?service=WCS&version=1.1.2&Request=GetCoverage&format=text/csv&store=true&identifier=ASOS&RangeSubset=BEXT[location[13935]]&TimeSequence=2010-05-01T00:00:00Z/2010-06-20T00:00:00Z/PT1M

Same query, but The parameter store=false returns both the XML envelope and the CSV file in the same request.

So far only Mozilla Firefox can open it automatically. Internet Explorer, Safari and Chrome are not recommended here.

http://128.252.202.19:8080/NCDC?service=WCS&version=1.1.2&Request=GetCoverage&format=text/csv&store=false&identifier=ASOS&RangeSubset=BEXT[location[13935]]&TimeSequence=2010-05-01T00:00:00Z/2010-06-20T00:00:00Z/PT1M