Datapoints.Query

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

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

uuid.UUID

The ID of the dataset to query.

[]datasets.QueryOption

Options for querying datapoints.

Options

required

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

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

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

Restrict the query to specific dataset collections by collection object.

Restrict the query to specific dataset collections by collection ID.

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.

default:"false"

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

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

Limit the total number of datapoints yielded by the sequence.

Returns

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

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),
    ),
)

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

Python

Go

Parameters

Options

Returns

​Parameters

​Options

​Returns

Parameters

Options

Returns