Search for items#

pygeodes let’s you also search for items, again provided you have a configured pygeodes.geodes.Geodes object (see Creating your Geodes object).

First query#

Then you can start making some queries, let’s start by retrieving all items whose orbit direction is 30972 :

query = {"spaceborne:absoluteOrbitID" : {"eq" : 30972}}
items,dataframe = geodes.search_items(query=query)

Searching by geometry#

You can also provide an intersects parameter, or a bbox parameter :

geometry = {
        "coordinates": [
        [
            [
            1.0292372559819398,
            44.60770095328709
            ],
            [
            1.2841512336040637,
            44.10175878425329
            ],
            [
            1.9222514382792326,
            45.25223094308308
            ],
            [
            0.7712475295708145,
            45.44578103385132
            ],
            [
            1.0292372559819398,
            44.60770095328709
            ]
        ]
        ],
        "type": "Polygon"
}

items,dataframe = geodes.search_items(intersects=geometry)

# or

bbox = [-0.112245,51.552873,-0.104177,51.557143]
items,dataframe = geodes.search_items(bbox=bbox)

Configuration#

By default, it returns a items object, which is a list of pygeodes.utils.stac.Item, and a dataframe object, which is a geopandas.GeoDataframe object (please refer to geopandas docs).

See also

For further formatting configuration, see Manipulating objects.

If you wish to get only the items, you can use the parameter return_df=False.

items = geodes.search_items(query=query,return_df=False)

By default, it returns all the objects corresponding to your query, so it can be long (making many API calls) if your query is not really precise. You could just want a little overview of the objects, you can set the parameter get_all=False, to get just the first items returned (by making just one API call).

items = geodes.search_items(query=query,return_df=False,get_all=False)