Data Locator was written as a web service so it can be called by other client applications (or other web services).
Consisting of two different web service calls, it can be called using a RESTful style interface (simply a URL) as follows:
"Search" Web Service And Parameters
Given the search parameters passed in, the "Search" web service returns a list of WCS URLS that match
the search criteria.
The example below returns 11 such matches.
| minDate |
-min date for search in ISO-8601 format (e.g., 2001-09-21T22:27:31Z) |
| maxDate |
-max date for search in ISO-8601 format (e.g., 2008-10-01T12:00:00Z) |
| minLat |
-min latitude for search (part of bounding box, e.g. 30.5) |
| maxLat |
-max latitude for search (part of bounding box, e.g. 89.9) |
| minLon |
-min longitude for search (part of bounding box, e.g. -180.0) |
| maxLon |
-max longitude for search (part of bounding box, e.g. 179.9) |
| serviceType |
-OGC web service type (e.g. 'WCS') |
| coverageLabel |
-a label or name for this coverage. Can be a partial (search) match like "temp" or "tem" |
| catalogDesc |
-the THREDDS catalog to search. Set catalogDesc=ALL to search all catalogs. |
"Search" Web Service Call
http://localhost:8080/axis2/services/DataLocatorService/search?minDate=2001-09-21T22:27:31Z&maxDate=2007-11-21T22:27:31Z&minLat=-90.0&maxLat=90.0&minLon=-180.0&maxLon=179.9&serviceType=WCS&coverageLabel=Geopotential&catalogDesc=nextgen.fsl.noaa.gov-FIM
Note: substitute in the actual computer name for "localhost".
"Search" Web Service Response (11 matches found)
"Register" Web Service And Parameters
Given a single parameter, the WCS URL passed in, the "Register" web service downloads the WCS data, and
registers
this downloaded dataset with ncWMS so it can be viewed later:
| wcsURL |
-web coverage service (WCS) URL. Note: the "&" chars should be replaced with "|" (pipe) chars |
"Register" Web Service Call
| Example 1 (FIM dew point temperature): |
| http://localhost:8080/axis2/services/DataLocatorService/registerDatasetWithNcWMS?wcsURL=http://int6.fsl.noaa.gov:8080/thredds/wcs/fim/0719800000000?request=GetCoverage|version=1.0.0|service=WCS|CRS=WGS84(DD)|RESPONSE_CRS=EPSG:4326|format=NetCDF3|coverage=Dew_point_temperature|BBOX=0.0,-90.0,359.9,90.0 |
| Example 2 (FIM pressure): |
| http://localhost:8080/axis2/services/DataLocatorService/registerDatasetWithNcWMS?wcsURL=http://int6.fsl.noaa.gov:8080/thredds/wcs/fim/0719800000120?request=GetCoverage|version=1.0.0|service=WCS|CRS=WGS84(DD)|RESPONSE_CRS=EPSG:4326|format=NetCDF3|coverage=Pressure|BBOX=0.0,-90.0,359.9,90.0 |
Note: substitute in the actual computer name for "localhost".
Note: the part of the URL above that is blue can be obtained from calling the "Search" web service.
"Register" Web Service Response
For more information about the "Search" and "Register" web services, view the DataLocatorService Javadocs.
The rest of the Javadocs are here.
|
