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

Search Granules

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

Description

Search Granule does granule searching on PO.DAAC level 2 swath datasets (individual orbits of a satellite), and level 3 & 4 gridded datasets (time averaged to span the globe). Coverage footpritnt polygons are used to enable spatial search on level 2 swath dataset. Currently, our footprints can contain no data and also gaps in the swath data. Spatial search on level 2 data can return granules where actual data does not intersect the selected bounding box but its footprint intersects the selected bounding box. The following parameters are supported: datasetId, shortName, startTime, endTime, bbox, and others.

OpenSearch

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

Available Dataset

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
PODAAC-AKASA-XOGD1ALTIKA_SARAL_L2_OST_XOGDR
PODAAC-GHAM2-2PR72AMSR2-REMSS-L2P-v7.2
PODAAC-ASOP2-25X01ASCATA-L2-25km
PODAAC-ASOP2-12C01ASCATA-L2-Coastal
PODAAC-ASOP2-25B01ASCATB-L2-25km
PODAAC-ASOP2-COB01ASCATB-L2-Coastal
PODAAC-GHAMT-2PE01EUR-L2P-AVHRR_METOP_A
PODAAC-GHMDA-2PJ01JPL-L2P-MODIS_A
PODAAC-GHMDT-2PJ01JPL-L2P-MODIS_T
PODAAC-GH18G-2PN01NAVO-L2P-AVHRR18_G
PODAAC-GH19G-2PN01NAVO-L2P-AVHRR19_G
PODAAC-GHMTG-2PN01NAVO-L2P-AVHRRMTA_G
PODAAC-OSCT2-L2BV2OS2_OSCAT_LEVEL_2B_OWV_COMP_12_V2
PODAAC-J2ODR-GPS00OSTM_L2_OST_OGDR_GPS
PODAAC-QSX12-L2B01QSCAT_LEVEL_2B_OWV_COMP_12
PODAAC-GHAMS-2PR01REMSS-L2P-AMSRE
PODAAC-GHVRS-2PN02VIIRS_NPP-NAVO-L2P-v1.0

Parameters

BOLD = required

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

Example: PODAAC-ASOP2-25X01
shortName Description: dataset shortname. datasetId or shortName is required for a granule search.

Example: ASCATA-L2-25km
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: Search granules with Dataset ID = PODAAC-GHMDA-2PJ01 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-GHMDA-2PJ01&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: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 Name
	</title>
	<updated>
		2012-04-14T00:17:13.103655Z
	</updated>
	<id>
		tag:podaac.jpl.nasa.gov:8890,2012-04-14
	</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&datasetId=PODAAC-GHMDA-2PJ01&startTime=2011-01-01T01%3A01%3A00Z" rel="self"
type="application/atom+xml"/>
	<link href="http://podaac.jpl.nasa.gov/ws/search/granule?startIndex=0&datasetId=PODAAC-GHMDA-2PJ01&startTime=2011-01-01T01%3A01%3A00Z" rel="first"
type="application/atom+xml"/>
	<link href="http://podaac.jpl.nasa.gov/ws/search/granule?startIndex=2&datasetId=PODAAC-GHMDA-2PJ01&startTime=2011-01-01T01%3A01%3A00Z" rel="next"
type="application/atom+xml"/>
	<opensearch:totalResults>
		46314
	</opensearch:totalResults>
	<opensearch:startIndex>
		0
	</opensearch:startIndex>
	<opensearch:itemsPerPage>
		2
	</opensearch:itemsPerPage>
	<entry>
		<title>
			20110607-MODIS_A-JPL-L2P-A2011158081500.L2_LAC_GHRSST_D-v01.nc
		</title>
		<updated>
			2011-06-07T08:15:08Z
		</updated>
		<id>
			PODAAC-GHMDA-2PJ01:20110607-MODIS_A-JPL-L2P-A2011158081500.L2_LAC_GHRSST_D-v01.nc
		</id>
		<link href="http://podaac.jpl.nasa.gov/ws/search/granule?full=true&granuleName=20110607-MODIS_A-JPL-L2P-A2011158081500.L2_LAC_GHRSST_D-v01.nc&
datasetId=PODAAC-GHMDA-2PJ01" rel="enclosure" title="PO.DAAC Metadata" type="application/atom+xml"/>
		<link href="http://podaac.jpl.nasa.gov/ws/metadata/granule?granuleName=20110607-MODIS_A-JPL-L2P-A2011158081500.L2_LAC_GHRSST_D-v01.nc&datasetId=
PODAAC-GHMDA-2PJ01&format=iso" rel="enclosure" title="ISO-19115 Metadata" type="text/xml"/>
		<link href="http://podaac.jpl.nasa.gov/ws/metadata/granule?granuleName=20110607-MODIS_A-JPL-L2P-A2011158081500.L2_LAC_GHRSST_D-v01.nc&datasetId=
PODAAC-GHMDA-2PJ01&format=fgdc" rel="enclosure" title="FGDC Metadata" type="text/xml"/>
		<link href="http://podaac-opendap.jpl.nasa.gov/opendap/allData/ghrsst/data/L2P/MODIS_A/JPL/2011/158/20110607-MODIS_A-JPL-L2P-A2011158081500.L2_LAC_
GHRSST_D-v01.nc.bz2.html"
		rel="enclosure" title="OPeNDAP URL" type="text/html"/>
		<link href="ftp://podaac-ftp.jpl.nasa.gov/allData/ghrsst/data/L2P/MODIS_A/JPL/2011/158/20110607-MODIS_A-JPL-L2P-A2011158081500.L2_LAC_GHRSST_D-v01.
nc.bz2"
		 rel="enclosure" title="FTP URL" type="application/x-netcdf"/>
		<podaac:datasetId>
			PODAAC-GHMDA-2PJ01
		</podaac:datasetId>
		<podaac:shortName>
			JPL-L2P-MODIS_A
		</podaac:shortName>
		<georss:where>
			<gml:Envelope>
				<gml:lowerCorner>
					46.37300109863281 39.57400131225586
				</gml:lowerCorner>
				<gml:upperCorner>
					86.8550033569336 61.409000396728516
				</gml:upperCorner>
			</gml:Envelope>
		</georss:where>
		<time:start>
			2011-06-07T08:15:08Z
		</time:start>
		<time:end>
			2011-06-07T08:20:05Z
		</time:end>
	</entry>
	<entry>
		<title>
			20110607-MODIS_A-JPL-L2P-A2011158080500.L2_LAC_GHRSST_D-v01.nc
		</title>
		<updated>
			2011-06-07T08:05:08Z
		</updated>
		<id>
			PODAAC-GHMDA-2PJ01:20110607-MODIS_A-JPL-L2P-A2011158080500.L2_LAC_GHRSST_D-v01.nc
		</id>
		<link href="http://podaac.jpl.nasa.gov/ws/search/granule?full=true&granuleName=20110607-MODIS_A-JPL-L2P-A2011158080500.L2_LAC_GHRSST_D-v01.nc&
datasetId=PODAAC-GHMDA-2PJ01" rel="enclosure" title="PO.DAAC Metadata" type="application/atom+xml"/>
		<link href="http://podaac.jpl.nasa.gov/ws/metadata/granule?granuleName=20110607-MODIS_A-JPL-L2P-A2011158080500.L2_LAC_GHRSST_D-v01.nc&
datasetId=PODAAC-GHMDA-2PJ01&format=iso" rel="enclosure" title="ISO-19115 Metadata" type="text/xml"/>
		<link href="http://podaac.jpl.nasa.gov/ws/metadata/granule?granuleName=20110607-MODIS_A-JPL-L2P-A2011158080500.L2_LAC_GHRSST_D-v01.nc&
datasetId=PODAAC-GHMDA-2PJ01&format=fgdc" rel="enclosure" title="FGDC Metadata" type="text/xml"/>
		<link href="http://podaac-opendap.jpl.nasa.gov/opendap/allData/ghrsst/data/L2P/MODIS_A/JPL/2011/158/20110607-MODIS_A-JPL-L2P-A2011158080500.L2_LAC_
GHRSST_D-v01.nc.bz2.html" rel="enclosure" title="OPeNDAP URL" type="text/html"/>
		<link href="ftp://podaac-ftp.jpl.nasa.gov/allData/ghrsst/data/L2P/MODIS_A/JPL/2011/158/20110607-MODIS_A-JPL-L2P-A2011158080500.L2_LAC_GHRSST_D-v01.
nc.bz2" rel="enclosure" title="FTP URL" type="application/x-netcdf"/>
		<podaac:datasetId>
			PODAAC-GHMDA-2PJ01
		</podaac:datasetId>
		<podaac:shortName>
			JPL-L2P-MODIS_A
		</podaac:shortName>
		<georss:where>
			<gml:Envelope>
				<gml:lowerCorner>
					66.47100067138672 4.685999870300293
				</gml:lowerCorner>
				<gml:upperCorner>
					92.12100219726562 25.65399932861328
				</gml:upperCorner>
			</gml:Envelope>
		</georss:where>
		<time:start>
			2011-06-07T08:05:08Z
		</time:start>
		<time:end>
			2011-06-07T08:10:07Z
		</time:end>
	</entry>
</feed>

Sample Run


BOLD = required

Parameter Value
datasetId example: PODAAC-ASOP2-25X01
shortName example: ASCATA-L2-25km
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