`
Web Service Overview | Description | OpenSearch | Available Dataset | Parameters | Examples | Response | Sample Run
PO.DAAC Web Services

Granule Search

URL http://podaac.jpl.nasa.gov/ws/search/granule
Related Resources Search Dataset

Description

The Granule Search web service finds granules meeting the specified search criteria in PO.DAAC level 2 swath datasets (individual orbits of a satellite), and level 3 & 4 gridded datasets (time averaged to span the globe). Coverage footprint polygons are used to enable spatial search on level 2 swath datasets. These coverage footprints do not reflect data gaps and will occasionally contain no data at all. Therefore, spatial search on level 2 data can return granules where there is no data in the selected bounding box even though the footprint indicates that there is.

The following parameters are supported: datasetId, startTime, endTime, bbox, and others.

OpenSearch

OpenSearch Description XML: http://podaac.jpl.nasa.gov/ws/search/dataset/osd.xml

Available Datasets

This service is only available for the following datasets

Dataset ID Short Name

*For Level 2 datasets, the following datasets are available for spatial search using bbox parameter.

Dataset ID Short Name

Parameters

BOLD = required

Parameter Details
datasetId Description: dataset persistent ID. datasetId is required for a granule search.

Example: PODAAC-ASOP2-25X01
startTime Description: start time in the format of YYYY-MM-DDTHH:mm:ssZ. 'Z' is the time-offset, where 'Z' signifies UTC or an actual offset can be used.

Example: 2013-01-01T01:30:00Z
endTime Description: stop time in the format of YYYY-MM-DDTHH:mm:ssZ. 'Z' is the time-offset, where 'Z' signifies UTC or an actual offset can be used.

Example: 2014-01-01T00:00:00Z
bbox Description: bounding box for spatial search. format should look like "bbox=0,0,180,90" which is in order of west, south, east, north. Longitude values needs to be in range of [-180, 180]. Latitude values needs to be in range of [-90, 90]

For level 2 dataset, spatial search is available for the following datasets. Click here to see the list.

Example: 0,0,180,90
startIndex Description: start index of entries found for search.

Example: 1
itemsPerPage Description: number of results per page for opensearch result. If format is not specified, format is set to 7.

The value range is from 0 to 400
sortBy Description: determines ordering of response.

Possible values: timeAsc, timeDesc.
format Description: response format. If format is not specified, format is set to atom.

Possible values: atom, html.
pretty Description: "true" to enable pretty output for xml. If pretty is not specified, pretty is set to true.

Possible values: true, false

Example Usage

Example 1: Granule search with Dataset ID = PODAAC-ASOP2-25X01 and date time later than 2011-01-01 01:01:00 and return the first item.

http://podaac.jpl.nasa.gov/ws/search/granule?datasetId=PODAAC-ASOP2-25X01&startTime=2011-01-01T01:01:00Z&itemsPerPage=1

Atom Response Syntax

* Atom title contains the granuleName


<feed xmlns="http://www.w3.org/2005/Atom" xmlns:georss="http://www.georss.org/georss" xmlns:gml="http://www.opengis.net/gml" xmlns:opensearch="http://a9.com/-/spec/
opensearch/1.1/" xmlns:podaac="http://podaac.jpl.nasa.gov/opensearch/" xmlns:time="http://a9.com/-/opensearch/extensions/time/1.0/">
	<title>
		[granuleName]
	</title>
	<updated>
		[executed timestamp]
	</updated>
	<id>
		[id]
	</id>
	<author>
		<name>
			[name]
		</name>
	</author>
	<link/>  [related links]
	<opensearch:totalResults>
		[total result count]
	</opensearch:totalResults>
	<opensearch:startIndex>
		[start index]
	</opensearch:startIndex>
	<opensearch:itemsPerPage>
		[items per page]
	</opensearch:itemsPerPage>
	<entry>
		<title>
			[result entry title]
		</title>
		<updated>
			[result entry updated timestamp]
		</updated>
		<id>
			[result entry id]
		</id>
		<link/>  [related links]
		<podaac:datasetId>
			[PODAAC Dataset ID]
		</podaac:datasetId>
		<podaac:shortName>
			[PODAAC Short Name]
		</podaac:shortName>
		<georss:where>
			<gml:Envelope>
				<gml:lowerCorner>
					[longitude, latitude]
				</gml:lowerCorner>
				<gml:upperCorner>
					[longitude, latitude]
				</gml:upperCorner>
			</gml:Envelope>
		</georss:where>
		<time:start>
			[start time]
		</time:start>
		<time:end>
			[end time]
		</time:end>
	</entry>
</feed>


Atom Response Example


<?xml version="1.0" ?>
<feed xmlns="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/terms/" xmlns:georss="http://www.georss.org/georss" xmlns:gml="http://www.opengis.net/gml" xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/" xmlns:podaac="http://podaac.jpl.nasa.gov/opensearch/" xmlns:time="http://a9.com/-/opensearch/extensions/time/1.0/">
	<title>
		PO.DAAC Granule Search Results
	</title>
	<updated>
		2016-07-26T23:14:51.621164Z
	</updated>
	<id>
		tag:podaac.jpl.nasa.gov,2016-07-26
	</id>
	<author>
		<name>
			PO.DAAC Granule Search Service
		</name>
	</author>
	<link href="http://podaac.jpl.nasa.gov/ws/search/podaac-dataset-osd.xml" rel="search" type="application/opensearchdescription+xml"/>
	<link href="http://podaac.jpl.nasa.gov/ws/search/granule?startIndex=0&itemsPerPage=1&datasetId=PODAAC-ASOP2-25X01&format=atom" rel="self" type="application/atom+xml"/>
	<link href="http://podaac.jpl.nasa.gov/ws/search/granule?startIndex=0&itemsPerPage=1&datasetId=PODAAC-ASOP2-25X01&format=atom" rel="first" type="application/atom+xml"/>
	<link href="http://podaac.jpl.nasa.gov/ws/search/granule?startIndex=1&amp;itemsPerPage=1&datasetId=PODAAC-ASOP2-25X01&format=atom" rel="next" type="application/atom+xml"/>
	<opensearch:totalResults>
		46708
	</opensearch:totalResults>
	<opensearch:startIndex>
		0
	</opensearch:startIndex>
	<opensearch:itemsPerPage>
		1
	</opensearch:itemsPerPage>
	<entry>
		<title>
			ascat_20160428_081500_metopa_49421_eps_o_250_2401_ovw.l2.nc
		</title>
		<updated>
			2016-04-28T08:15:00Z
		</updated>
		<id>
			PODAAC-ASOP2-25X01:ascat_20160428_081500_metopa_49421_eps_o_250_2401_ovw.l2.nc
		</id>
		<link href="http://podaac.jpl.nasa.gov/ws/search/granule?full=true&granuleName=ascat_20160428_081500_metopa_49421_eps_o_250_2401_ovw.l2.nc&datasetId=PODAAC-ASOP2-25X01" rel="enclosure" title="PO.DAAC Metadata" type="application/atom+xml"/>
		<link href="http://podaac.jpl.nasa.gov/ws/metadata/granule?granuleName=ascat_20160428_081500_metopa_49421_eps_o_250_2401_ovw.l2.nc&datasetId=PODAAC-ASOP2-25X01&format=iso" rel="enclosure" title="ISO-19115 Metadata" type="text/xml"/>
		<link href="http://podaac.jpl.nasa.gov/ws/metadata/granule?granuleName=ascat_20160428_081500_metopa_49421_eps_o_250_2401_ovw.l2.nc&datasetId=PODAAC-ASOP2-25X01&format=fgdc" rel="enclosure" title="FGDC Metadata" type="text/xml"/>
		<link href="http://podaac-opendap.jpl.nasa.gov/opendap/allData/ascat/preview/L2/metop_a/25km/2016/119/ascat_20160428_081500_metopa_49421_eps_o_250_2401_ovw.l2.nc.gz.html" rel="enclosure" title="OPeNDAP URL" type="text/html"/>
		<link href="ftp://podaac-ftp.jpl.nasa.gov/allData/ascat/preview/L2/metop_a/25km/2016/119/ascat_20160428_081500_metopa_49421_eps_o_250_2401_ovw.l2.nc.gz" rel="enclosure" title="FTP URL" type="application/x-netcdf"/>
		<podaac:datasetId>
			PODAAC-ASOP2-25X01
		</podaac:datasetId>
		<podaac:shortName>
			ASCATA-L2-25km
		</podaac:shortName>
		<georss:box>
			-89.33356 0.0007700000000000001 89.22791000000001 359.99835
		</georss:box>
		<georss:where>
			<gml:Envelope>
				<gml:lowerCorner>
					0.0007700000000000001 -89.33356
				</gml:lowerCorner>
				<gml:upperCorner>
					359.99835 89.22791000000001
				</gml:upperCorner>
			</gml:Envelope>
		</georss:where>
		<time:start>
			2016-04-28T08:15:00Z
		</time:start>
		<time:end>
			2016-04-28T09:56:56Z
		</time:end>
		<dc:identifier>
			PODAAC-ASOP2-25X01:ascat_20160428_081500_metopa_49421_eps_o_250_2401_ovw.l2.nc
		</dc:identifier>
		<dc:date>
			2016-04-28T08:15:00Z/2016-04-28T09:56:56Z
		</dc:date>
	</entry>
</feed>


Sample Run


BOLD = required

Parameter Value
datasetId example: PODAAC-ASOP2-25X01
startTime example: 2013-01-01T01:30:00Z
endTime example: 2014-01-01T00:00:00Z
bbox example: 0,0,180,90

For level 2 dataset, spatial search is available for the following datasets. Click here to see the list.
startIndex example: 1
itemsPerPage example: 10
sortBy
format
pretty