---
title: "Datapoints.Query"
description: "Query datapoints from one or more collections of the same dataset."
image: "https://tilebox.com/images/tilebox-docs-social-preview.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://tilebox.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Datapoints.Query

import { Fragment } from "astro/jsx-runtime";

import ApiReference from "@docs/components/ApiReference.astro";

import ParamField from "@docs/components/ParamField.astro";

```go
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](/docs/api-reference/go/datasets/CollectAs) or [As](/docs/api-reference/go/datasets/As) functions.

## Parameters

**datasetID**

type: uuid.UUID

The ID of the dataset to query.
**options**

type: []datasets.QueryOption

Options for querying datapoints.

## Options

**WithTemporalExtent(temporalExtent query.TemporalExtent)**

required: true

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](/docs/datasets/query/filter-by-location#spatial-filter-modes) 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.

See [Filter by custom fields](/docs/datasets/query/filter-by-fields) for comparisons, boolean expressions, and null checks.

<h2 id="request-example">Usage example</h2>

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

Source: https://tilebox.com/docs/api-reference/go/datasets/Datapoints.Query/index.mdx