Showing results for 
Search instead for 
Do you mean 

APOLLO Catalog WCS endpoint

by Technical Evangelist ‎07-10-2020 08:51 AM - edited ‎09-15-2020 11:52 AM (184 Views)

Here are the Apollo catalog WCS endpoint urls:
http://<APOLLO>/erdas-apollo/coverage_public/EAIM?request=getCapabilities&service=WCS

http://<APOLLO>/erdas-apollo/coverage/EAIM?request=getCapabilities&service=WCS 

 

[1] http://<APOLLO>/erdas-apollo/coverage_public/EAIM?  
This is public WCS access endpoint, which will allow anonymous access
User need to can set "*" principal on any aggregate or dataset that they want anonymous access using Apollo data manager->"Security ..." Dialog.

Right-click on aggregate or dataset in Data manager, choose "Security..." option, then add "*" principal.

01.jpg


Then user can access that dataset or aggregate via WCS using anonymous access WCS URL: http://<APOLLO>/erdas-apollo/coverage_public/EAIM?

 


[2] http://<APOLLO>/erdas-apollo/coverage/EAIM? 
This is non-annoymous WCS access endpoint, which will be protected by Apollo catalog security.

 

[3] Enable Dataset level WCS

By default APOLLO WCS endpoint only allow aggregate level acess.

http://<APOLLO>/erdas-apollo/coverage_public/EAIM?request=getCapabilities&service=WCS

http://<APOLLO>/erdas-apollo/coverage/EAIM?request=getCapabilities&service=WCS 

 

User can modify the following provider file to enable dataset level WCS

C:\Program Files\Hexagon\ERDAS APOLLO\config\erdas-apollo\providers\coverage\im-providers.fac

Change "exposure" value from "SHOW_AGGREGATES" to "SHOW_ALL", then restart tomcat.

Note: Expose WCS in dataset level may lead to poor performances as the getCapabilities document could be huge to produce

wcs.png


[4] User can request WCS service for individual dataset in APOLLO catalog.

If user knows the layer name of any dataset in APOLLO catalog, user can use WCS DescribeCoverage to

http://<APOLLO>/erdas-apollo/coverage_public/EAIM?request=DescribeCoverage&service=WCS&version=1.0.0&coverage=<layername>
http://<APOLLO>/erdas-apollo/coverage/EAIM?request=DescribeCoverage&service=WCS&version=1.0.0&coverage=<layername>

 

NOTE: for WCS 2.0.1, use "coverageid=<layername>" instead of "coverage=<layername>"

 

http://<APOLLO>/erdas-apollo/coverage_public/EAIM?request=DescribeCoverage&service=WCS&version=1.0.0&coverageid=<layername>

 

NOTE: Apollo 2020 update 3 added support for WCS 2.0.1 SCALESIZE support.
The following example shows how to get cataloged image as 500x500 scale down.

 

http://localhost/erdas-apollo/coverage/EAIM?SERVICE=WCS&VERSION=2.0.1&REQUEST=GetCoverage&COVERAGEID=mydataset&SCALESIZE=X(500),Y(500)

If user specify "Maximum pixels per WCS request" as -1 (Data manager->Configuration->Provisioning), then user can download the full resultion image like this

 

 

http://localhost/erdas-apollo/coverage/EAIM?SERVICE=WCS&VERSION=2.0.1&REQUEST=GetCoverage&COVERAGEID=mydataset

Maximum pixels per WCS request has nothing to do with "Data manager->Configuration->Clip/Zip/Ship->Download Maximum Request Size(MB)"

 

 

 

 

User can use APOLLO portal to download or CZS cataloged dataset (WCS GetCoverage request)


[5] User can also use ERDAS IMAGINE to access WCS

IMAGINE->File->Open->Web Service... (IMAGINE 2020 support WCS 1.0.0, WCS 1.1.0, WCS 1.1.1)

Select the image and click OK. The WCS will be loaded into IMAGINE viewer. IMAGINE will treat WCS as actual image, so user can perform regular raster operations (e.g, subset, modeling...)

IMAGINE.png

 

Note: IMAGINE->Open->ERDAS APOLLO, will allow user to access the same dataset, but only in WMS.

 

IWS.jpg

Comments
by
on ‎07-21-2020 12:35 AM

Thanks Haiyan,

 

this is very helpful for everyone. A short remark regarding WCS 2.0.1

 

Use the following calls in order to switch from WCS 1.0.0 to 2.0.1:

 

GetCapabilities

http://<APOLLO>/erdas-apollo/coverage/EAIM?request=getCapabilities&service=WCS&version=2.0.1

 

DescribeCoverage:

http://<APOLLO>/erdas-apollo/coverage/EAIM?request=DescribeCoverage&service=WCS&version=2.0.1&coverageid=<layername>

Take care - WCS 2.0.1 needs coverageid instead of coverage which is used in WCS 1.0.0.

 

Cheers

Fritz

Contributors