Datapoints.Query

func (datapointClient) Query(
    ctx context.Context,
    datasetID uuid.UUID,
    options ...datasets.QueryOption,
) iter.Seq2[[]byte, error]

Copy

Query datapoints from one or more collections of the same dataset.

The datapoints are lazily queried across pages and returned as a sequence of bytes. The output sequence can be transformed into a typed proto.Message using CollectAs or As functions.

Parameters

datasetID uuid.UUID

The ID of the dataset to query.

options []datasets.QueryOption

Options for querying datapoints.

Options

WithTemporalExtent(temporalExtent query.TemporalExtent) required

Specify the time interval for which data should be queried. Right now, a temporal extent is required for every query.

WithSpatialExtent(spatialExtent orb.Geometry)

Specify the geographical extent in which to query data. Optional, if not specified the query will return all results found globally.

WithSpatialExtentFilter(spatialExtent query.SpatialExtent)

Specify a geographical extent with an explicit spatial filter mode and coordinate system.

WithCollections(collections ...*datasets.Collection)

Restrict the query to specific dataset collections by collection object.

WithCollectionIDs(collectionIDs ...uuid.UUID)

Restrict the query to specific dataset collections by collection ID.

WithFilters(filters ...query.Expression)

Filter by fields marked queryable in the dataset schema. Multiple expressions are combined with each other and with temporal, spatial, and collection filters using logical AND.

WithSkipData()

Default: false

Skip the data when querying datapoints. If set, only the required and auto-generated fields will be returned.

WithCursor(cursor *datasets.Cursor)

Start the query after the cursor returned by a previous page.

WithLimit(limit int64)

Limit the total number of datapoints yielded by the sequence.

Returns

A sequence of bytes containing the requested data points as bytes.

Request example

Go

import (
  "time"
  datasets "github.com/tilebox/tilebox-go/datasets/v1"
	"github.com/tilebox/tilebox-go/query"
)

startDate := time.Date(2014, 10, 4, 0, 0, 0, 0, time.UTC) 
endDate := time.Date(2021, 2, 24, 0, 0, 0, 0, time.UTC) 
queryInterval := query.NewTimeInterval(startDate, endDate)

datapoints, err := datasets.CollectAs[*v1.Sentinel1Sar](
    client.Datapoints.Query(
      ctx,
      dataset.ID,
      datasets.WithCollectionIDs(collection.ID),
      datasets.WithTemporalExtent(queryInterval),
    ),
)

Copy

See Filter by custom fields for comparisons, boolean expressions, and null checks.