U.S. flag

An official website of the United States government

Official websites use .gov
A .gov website belongs to an official government organization in the United States.

Secure .gov websites use HTTPS
A lock ( ) or https:// means you’ve safely connected to the .gov website. Share sensitive information only on official, secure websites.

Untitled Document
Astrogeology Analysis Ready Data
Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Toggle Dark/Light/Auto mode Back to homepage
Edit page

Query the API using sat-search

In this example, we will walk through a number of different queries that can be submitted to the USGS STAC API in order to discover and download data. This example is organized in order of what see as increasing complexity. First, we will walk through funding data for a single body. Then we will add a spatial filter. Finally, we will layer on a more complex attribute query in order to find data that meets a series of criteria. In terms of plan language questions, we will show how to answer the following using the command line tool sat-search.

  1. What Europa data are available?
  2. What Europa data are available in my area of interest?
  3. What Europa data are available in my area of interest that have a pixel resolution less than X?
  4. What Europa data are available in my area of interest that have a pixel resolution less than X and viewing geometry parameters in some range?

Let’s get started!

If you are wondering what sat-search is and what this example is all about, head over to our tutorial Discovering and Downloading Data via the Command Line .

What Europa data are available?

Two options exist for finding body specific information. The first option is to know the computer name of the STAC collection that you wish to search. For this example, we actually want to search over two different (at the time of writing) STAC collections. Here is an example of such a query:

Questions or Comments?

Discuss the Data