Difference between revisions of "WCS GetCoverage Query"

Revision as of 14:00, September 6, 2010

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

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

Examples:

CIRA/VIEWS small geo range for one datetime &store=true

GetCoverage for points

CIRA/VIEWS small geo range for one datetime &store=false

CIRA/VIEWS small geo range for one datetime &store=true

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

@@ Line 1: / Line 1: @@
 {{WCS Glossary
 |Glossary Domain=WCS
-|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.
+|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 [[Coverage_Processor_for_Cubes|Cubes]] or [[Coverage_Processor_for_Points|Points]] processes the query and produces data returned to the client.
 |Links=[[Coverage_Processor_for_Cubes|Coverage Processor for Cubes]] [[Coverage_Processor_for_Points|Coverage Processor for Points]]
 }}
-TODO: More tested examples.
+=== Dissecting a WCS Query ===
 Address, port and provider
@@ Line 27: / Line 28: @@
      TimeSequence=2008-07-02/2008-07-08/P3D
 Selecting field SO4f only.
@@ Line 43: / Line 43: @@
 Live Query: [http://128.252.202.19:8080/CIRA?Service=WCS&Version=1.1.2&Request=GetCoverage&Identifier=VIEWS&BoundingBox=-100,30,-90,40,urn:ogc:def:crs:OGC:2:84&TimeSequence=2008-07-02/2008-07-08/P3D&RangeSubset=SO4f&Format=text/csv&Store=true VIEWS Map slice for SO4f]
-Examples:
+=== Examples: ===
 [http://128.252.202.19:8080/CIRA?Service=WCS&Version=1.1.2&Request=GetCoverage&Identifier=VIEWS&Format=text/csv&Store=false&TimeSequence=2008-07-02&RangeSubset=SO4f&BoundingBox=-100,30,-90,40,urn:ogc:def:crs:OGC:2:84 CIRA/VIEWS small geo range for one datetime &store=true]