Inventory

Returns a list of inventory (granule) information for the requested product. This service is powered by NASA CMR. Spatial query priority is (latitude, longitude), bounding box, then polygon. Temporal priority is date then (julianrange, years)

Parameters

NameDescriptionDefaultChoicesRequired
product The product to find (i.e. MOD09A1, MOD13Q1, MYD11A2, WELDUSSE). Product may also include version, if version parameter is omitted (i.e. MOD09A1.006, MOD13Q1.005, WELDUSSE.001). Also as shortname. True
version The product version. Format may include leading zeros or decimals (i.e. 5, 005, 5.5, 006) 5 False
latitude A latitude value. Positive values are N, negative values are S. Also as lat. False
longitude A longitude value. Positive values are E, negative values are W. Also as lon. False
bbox AOI bounding box lower left longitude, lower left latitude, upper right longitude, upper right latitude. False
polygon Polygon shape search. The values are listed comma separated in longitude latitude order, i.e. lon1, lat1, lon2, lat2, lon3, lat3, and so on. False
date Date(s) to search ISO-8601 compliant. Accepts single date or interval with a start and end date. Time information is ignored. Separate multiple dates with a colon(:).Example: 2000-01-01/2015-11-30 False
julianrange A julian day range to search. Repeats for all years in dataset unless year parameter is specified. From 1-366 False
years A year range to search. Used with julianrange. False
return A value to respond with. Alias as response. url url location opendap 1 mm-dd-yyyy dd-mm-yyyy Ayyyyjjj 0 metadataurl browseurl False
page_size The size of return pages. 0 is return all results 0 False
page_num The page number to return. Defaults to page 1 if page_size is not 0. False
output The output style for the results. xml xml json html text False

Example

./inventory?product=MCD43A4&version=5&latitude=23&longitude=-100&return=location&julianrange=41-90&years=2000

Response

	    <inventory>
		    <file>
		    MOTA/MCD43A4.005/2000.02.18/MCD43A4.A2000049.h08v06.005.2006269085250.hdf
		    </file>
		    <file>
		    MOTA/MCD43A4.005/2000.02.26/MCD43A4.A2000057.h08v06.005.2006270125624.hdf
		    </file>
		    <file>
		    MOTA/MCD43A4.005/2000.03.05/MCD43A4.A2000065.h08v06.005.2006271222109.hdf
		    </file>
		    <file>
		    MOTA/MCD43A4.005/2000.03.13/MCD43A4.A2000073.h08v06.005.2006262143409.hdf
		    </file>
		    <file>
		    MOTA/MCD43A4.005/2000.03.21/MCD43A4.A2000081.h08v06.005.2006264123403.hdf
		    </file>
		    <file>
		    MOTA/MCD43A4.005/2000.03.29/MCD43A4.A2000089.h08v06.005.2006265223555.hdf
		    </file>
	    </inventory>
	    

Example

./inventory?product=MOD09A1&version=5&latitude=23&longitude=-100&return=url&date=2005-01-01/2010-12-31&page_size=5

Response

	    <inventory>
		<url>http://e4ftl01.cr.usgs.gov//MODIS_Composites/MOLT/MOD09A1.005/2004.12.26/MOD09A1.A2004361.h08v06.005.2008260142257.hdf</url>
		<url>http://e4ftl01.cr.usgs.gov//MODIS_Composites/MOLT/MOD09A1.005/2005.01.01/MOD09A1.A2005001.h08v06.005.2007352003748.hdf</url>
		<url>http://e4ftl01.cr.usgs.gov//MODIS_Composites/MOLT/MOD09A1.005/2005.01.09/MOD09A1.A2005009.h08v06.005.2007356035346.hdf</url>
		<url>http://e4ftl01.cr.usgs.gov//MODIS_Composites/MOLT/MOD09A1.005/2005.01.17/MOD09A1.A2005017.h08v06.005.2007358150133.hdf</url>
		<url>http://e4ftl01.cr.usgs.gov//MODIS_Composites/MOLT/MOD09A1.005/2005.01.25/MOD09A1.A2005025.h08v06.005.2007361135946.hdf</url>

	    </inventory>