Skip to main content

Search STAC items with filtering and return tiles.

GET 
/services/imagegrid/search

Retrieve items matching filters.

For authorization this method requires the use of a valid bearer token.

The GET /service/imagegrid/search operation supports the same search filter parameters as POST /service/imagegrid/search.

Request​

Query Parameters

    bbox string

    Bounding box in format "west,south,east,north" in WGS84 decimal degrees. When performing a spatial search specify either of the parameters "bbox" or "intersects", but not both.

    Example: -105,40,-104,41
    datetime string

    Date range filter in format "start-date/end-date" or "exact-datetime"

    Example: 2015-01-01T00:00:00Z/2016-01-01T00:00:00Z
    ids string

    Comma-separated list of STAC item IDs to return. The items returned are still subject to whatever other search filters are specified.

    Example: 1020010079424900,1030010021410300,4b63bf80-74a9-4884-8d26-cd322cce8a61-inv
    collections string

    Comma-separated list of collections to search in. By default all imagery collections are searched. It is an error if any collection in this list is not an imagery collection.

    Example: wv01,wv02,wv03-vnir
    intersects string

    GeoJSON geometry to search by. Must be either a Polygon or MultiPolygon geometry. Only STAC items whose geometries intersect this geometry are selected. When performing a spatial search specify either of the parameters "bbox" or "intersects", but not both.

    Example: {"type":"Polygon","coordinates":[[[-105,39],[-103,39],[-103,41],[-104,41],[-104,40],[-105,40],[-105,39]]]}
    filter string

    A cql2-text filter expression for filtering items. You can filter on any property inside a STAC item's "properties" object.

    While STAC items have a "datetime" property you should use the search operation's "datetime" parameter for searching by it, and not use the "filter" parameter for searching by datetime.

    Examples:

    Example: eo:cloud_cover < 20

    where string

    (Deprecated in favor of filter) SQL-style WHERE clause for filtering STAC items by properties. You can filter on any property inside a STAC item's "properties" object.

    While STAC items have a "datetime" property you should use the search operation's "datetime" parameter for searching by it, and not use the "where" parameter for searching by datetime.

    Examples:

    Example: eo:cloud_cover < 20

    limit integer

    Maximum number of items to return

    Example: 10
    last string

    STAC item ID of last tile returned in previous page. Next page of results will begin with tile after this one.

    Example: Z13-031131131131_10200100D2B4B200

Responses​

A GeoJSON feature collection.

Response Headers
  • X-Maxar-RequestId any
Schema
    type stringrequired

    Possible values: [FeatureCollection]

    features object[]required
  • Array [
    • id itemIdrequired

    Provider identifier, a unique ID, potentially a link to a file.

    collection collectionIdrequired

    Collection ID

    bbox number[]required

    Possible values: >= 4, <= 6

    Only features that have a geometry that intersects the bounding box are selected. The bounding box is provided as four or six numbers, depending on whether the coordinate reference system includes a vertical axis (elevation or depth):

    • Lower left corner, coordinate axis 1

    • Lower left corner, coordinate axis 2

    • Lower left corner, coordinate axis 3 (optional)

    • Upper right corner, coordinate axis 1

    • Upper right corner, coordinate axis 2

    • Upper right corner, coordinate axis 3 (optional)

    The coordinate reference system of the values is WGS84 longitude/latitude (http://www.opengis.net/def/crs/OGC/1.3/CRS84) unless a different coordinate reference system is specified in the parameter bbox-crs.

    For WGS84 longitude/latitude the values are in most cases the sequence of minimum longitude, minimum latitude, maximum longitude and maximum latitude. However, in cases where the box spans the antimeridian the first value (west-most box edge) is larger than the third value (east-most box edge).

    If a feature has multiple spatial geometry properties, it is the decision of the server whether only a single spatial geometry property is used to determine the extent or all relevant geometries.

    geometry objectrequired
    type itemTyperequired

    Possible values: [Feature]

    The GeoJSON type

    properties objectrequired

    provides the core metatdata fields plus extensions

    links object[]required
  • Array [
    • href urlrequired
    rel stringrequired
    type string
    title string
  • ]
    • assets objectrequired
    property name* object
    href urlrequired

    Link to the asset object

    title string

    Displayed title

    description string

    Multi-line description to explain the asset.

    CommonMark 0.29 syntax MAY be used for rich text representation.

    type string

    Media type of the asset

    roles string[]

    Purposes of the asset

  • ]
    • links object[]

    An array of links. Can be used for pagination, e.g. by providing a link with the next relation type.

  • Array [
    • href urlrequired
    rel stringrequired
    type string
    title string
  • ]
Loading...