LAADS Web Service Classic REST Examples
- General Service Information
- Product Information
- Search and Get File URLs
- Search and Order Files ( Simple )
- Search and Order with SDS Subset and Reformat
- Search and Order with Band Subset and Reprojection
- Search using OpenSearch
- ESIP Federated Search
- Check Order Status and Release
General Service Information
Various queries to find out what sorts of data products are available, for which satellites and in what geographic projections.
- http://modwebsrv.modaps.eosdis.nasa.gov/axis2/services/MODAPSservices/listSatelliteInstruments
- http://modwebsrv.modaps.eosdis.nasa.gov/axis2/services/MODAPSservices/listProductsByInstrument?instrument=AM1M
- http://modwebsrv.modaps.eosdis.nasa.gov/axis2/services/MODAPSservices/listMapProjections
Product Information
Get more specific information about a particular data product, including a list of Science Data Sets (SDS) and bands.
- http://modwebsrv.modaps.eosdis.nasa.gov/axis2/services/MODAPSservices/listProducts
- http://modwebsrv.modaps.eosdis.nasa.gov/axis2/services/MODAPSservices/getDataLayers?product=MOD021KM
- http://modwebsrv.modaps.eosdis.nasa.gov/axis2/services/MODAPSservices/getBands?product=MOD021KM
Search and Get File URLs
This is an easy way to get granules without any post processing. For example you may want to process them yourself, or perhaps they are already in the format you desire.
- http://modwebsrv.modaps.eosdis.nasa.gov/axis2/services/MODAPSservices/searchForFiles?product=MOD021KM&collection=5&start=2008-10-23&stop=2008-10-23&north=40&south=30&west=-80&east=-70&coordsOrTiles=coords&dayNightBoth=DNB
- http://modwebsrv.modaps.eosdis.nasa.gov/axis2/services/MODAPSservices/getFileProperties?fileIds=204846513,204718831
- http://modwebsrv.modaps.eosdis.nasa.gov/axis2/services/MODAPSservices/getFileUrls?fileIds=204846513,204718831
Search and Order Files (Simple)
Search for and order the granules. Ordering works just like LAADS Web, an email will be sent to the provided email when the order is ready. The files will be placed on a download server for you to download. Also, an order number will be returned immediately and you can check the status of your order using web service methods (see below).
- http://modwebsrv.modaps.eosdis.nasa.gov/axis2/services/MODAPSservices/searchForFiles?product=MOD021KM&collection=5&start=2008-10-23&stop=2008-10-23&north=40&south=30&west=-80&east=-70&coordsOrTiles=coords&dayNightBoth=DNB
- http://modwebsrv.modaps.eosdis.nasa.gov/axis2/services/MODAPSservices/orderFiles?fileIds=204846513,204718831&email=YOUR_EMAIL@example.com
Search and Order with SDS Subset and Reformat
This sequence searches for granules, gets a list of the SDSs in the granules, and orders the only one of the SDSs contained in the product's granule files. It also requests a reformat to JPEG for easy viewing.
- http://modwebsrv.modaps.eosdis.nasa.gov/axis2/services/MODAPSservices/searchForFiles?product=MOD021KM&collection=5&start=2008-10-23&stop=2008-10-23&north=40&south=30&west=-80&east=-70&coordsOrTiles=coords&dayNightBoth=DNB
- http://modwebsrv.modaps.eosdis.nasa.gov/axis2/services/MODAPSservices/getDataLayers?product=MOD021KM
- http://modwebsrv.modaps.eosdis.nasa.gov/axis2/services/MODAPSservices/orderFiles?fileIds=204846513,204718831&subsetDataLayer=MOD021KM___EV_1KM_Emissive&reformatType=jpeg&email=YOUR_EMAIL@example.com
Search and Order with Band Subset and Reprojection
This sequence searches for files, and orders them subsets SDS, subsets a single band, reprojects to ALBERS with default parameters, and reformats to geotiff.
- http://modwebsrv.modaps.eosdis.nasa.gov/axis2/services/MODAPSservices/searchForFiles?product=MOD021KM&collection=5&start=2008-10-23&stop=2008-10-23&north=40&south=30&west=-80&east=-70&coordsOrTiles=coords&dayNightBoth=DNB
- http://modwebsrv.modaps.eosdis.nasa.gov/axis2/services/MODAPSservices/getDataLayers?product=MOD021KM
- http://modwebsrv.modaps.eosdis.nasa.gov/axis2/services/MODAPSservices/getBands?product=MOD021KM
- http://modwebsrv.modaps.eosdis.nasa.gov/axis2/services/MODAPSservices/listMapProjections
- http://modwebsrv.modaps.eosdis.nasa.gov/axis2/services/MODAPSservices/orderFiles?fileIds=204846513,204718831&subsetDataLayer=MOD021KM___EV_1KM_Emissive&subsetBand=MOD021KM___3&reformatType=geotiff&reprojectionName=ALBERS&email=YOUR_EMAIL@example.com
Search using OpenSearch
Example of a granule level search which returns results in a OpenSearch compatible atom+xml format. See http://www.opensearch.org/ for more information.
ESIP Federated Search
ESIP Federated search is a workflow which starts at searching data providers at the dataset level, and ends at a granule level search for the providers offerings. See http://wiki.esipfed.org/index.php/Federated_Search for more information.
- http://modwebsrv.modaps.eosdis.nasa.gov/axis2/services/MODAPSservices/searchDatasets?pattern=mod02
- http://modwebsrv.modaps.eosdis.nasa.gov/axis2/services/MODAPSservices/getOSDD?product=MOD021KM
- http://modwebsrv.modaps.eosdis.nasa.gov/axis2/services/MODAPSservices/getOpenSearch?product=MOD021KM&collection=5&start=2008-10-23&stop=2008-10-23&bbox=-80,30,-70,40
Check Order Status and Release
A few functions are provided to manage your orders. Users are limited in the number of active orders at one time. Orders will automatically be released eventually, but you can do so manually as well to free up some of your allotment.
- http://modwebsrv.modaps.eosdis.nasa.gov/axis2/services/MODAPSservices/getOrderStatus?orderId=500575353
- http://modwebsrv.modaps.eosdis.nasa.gov/axis2/services/MODAPSservices/releaseOrder?orderId=500575353&email=YOUR_EMAIL@example.com