# Queries

## Raster Pixel Info

> Get a single pixel value at a given location.

```json
{"openapi":"3.1.0","info":{"title":"Earthscale Tiles API v1","version":"1.0.0"},"servers":[{"url":"/v1"}],"paths":{"/raster/{dataset_version_id}/pixels/{lon}/{lat}":{"get":{"tags":["Queries"],"summary":"Raster Pixel Info","description":"Get a single pixel value at a given location.","operationId":"Raster_Pixel_Info_raster__dataset_version_id__pixels__lon___lat__get","parameters":[{"name":"dataset_version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"UUID of the dataset version to query. Each dataset can have multiple versions representing different states of the data over time","title":"Dataset Version Id"},"description":"UUID of the dataset version to query. Each dataset can have multiple versions representing different states of the data over time"},{"name":"lon","in":"path","required":true,"schema":{"type":"number","description":"Longitude in decimal degrees (-180 to 180, WGS84/EPSG:4326)","title":"Lon"},"description":"Longitude in decimal degrees (-180 to 180, WGS84/EPSG:4326)"},{"name":"lat","in":"path","required":true,"schema":{"type":"number","description":"Latitude in decimal degrees (-90 to 90, WGS84/EPSG:4326)","title":"Lat"},"description":"Latitude in decimal degrees (-90 to 90, WGS84/EPSG:4326)"},{"name":"api_key","in":"query","required":true,"schema":{"type":"string","description":"Earthscale API key used to authenticate requests and determine which datasets you have access to. API keys can be managed in the [Earthscale Web App](https://app.earthscale.ai) under the user menu (top-right) -> 'API Settings'","title":"Api Key"},"description":"Earthscale API key used to authenticate requests and determine which datasets you have access to. API keys can be managed in the [Earthscale Web App](https://app.earthscale.ai) under the user menu (top-right) -> 'API Settings'"},{"name":"variable","in":"query","required":true,"schema":{"type":"string","description":"Name of the data variable/band to retrieve from the dataset (e.g., 'temperature', 'B4', 'elevation')","title":"Variable"},"description":"Name of the data variable/band to retrieve from the dataset (e.g., 'temperature', 'B4', 'elevation')"},{"name":"dimidx","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Dimension indices","description":"Select a slice from multi-dimensional datasets (e.g., with time or depth axes). Format: 'dimension:index' where index is zero-based. Example: 'time:0' selects the first timestep, 'depth:5' selects the 6th depth level. Repeat for multiple dimensions: ?dimidx=time:0&dimidx=depth:2. All extra dimensions of the dataset must be specified to select a single value"},"description":"Select a slice from multi-dimensional datasets (e.g., with time or depth axes). Format: 'dimension:index' where index is zero-based. Example: 'time:0' selects the first timestep, 'depth:5' selects the 6th depth level. Repeat for multiple dimensions: ?dimidx=time:0&dimidx=depth:2. All extra dimensions of the dataset must be specified to select a single value"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RasterPixelResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"RasterPixelResponse":{"properties":{"dimension_selection":{"additionalProperties":{"type":"integer"},"type":"object","title":"Dimension Selection"},"value":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"null"}],"title":"Value"}},"type":"object","required":["dimension_selection","value"],"title":"RasterPixelResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}
```

## Raster Pixel Info Series

> Get all pixel values for a given dimension and location.

```json
{"openapi":"3.1.0","info":{"title":"Earthscale Tiles API v1","version":"1.0.0"},"servers":[{"url":"/v1"}],"paths":{"/raster/{dataset_version_id}/pixels/{lon}/{lat}/{dim}":{"get":{"tags":["Queries"],"summary":"Raster Pixel Info Series","description":"Get all pixel values for a given dimension and location.","operationId":"Raster_Pixel_Info_Series_raster__dataset_version_id__pixels__lon___lat___dim__get","parameters":[{"name":"dataset_version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"UUID of the dataset version to query. Each dataset can have multiple versions representing different states of the data over time","title":"Dataset Version Id"},"description":"UUID of the dataset version to query. Each dataset can have multiple versions representing different states of the data over time"},{"name":"lon","in":"path","required":true,"schema":{"type":"number","description":"Longitude in decimal degrees (-180 to 180, WGS84/EPSG:4326)","title":"Lon"},"description":"Longitude in decimal degrees (-180 to 180, WGS84/EPSG:4326)"},{"name":"lat","in":"path","required":true,"schema":{"type":"number","description":"Latitude in decimal degrees (-90 to 90, WGS84/EPSG:4326)","title":"Lat"},"description":"Latitude in decimal degrees (-90 to 90, WGS84/EPSG:4326)"},{"name":"dim","in":"path","required":true,"schema":{"type":"string","description":"Name of the dimension to retrieve all values for (e.g., 'time'). Returns a time series or similar array of values at the given location. The dimension must be indexed in the dataset; use dimidx to fix other dimensions","title":"Dim"},"description":"Name of the dimension to retrieve all values for (e.g., 'time'). Returns a time series or similar array of values at the given location. The dimension must be indexed in the dataset; use dimidx to fix other dimensions"},{"name":"api_key","in":"query","required":true,"schema":{"type":"string","description":"Earthscale API key used to authenticate requests and determine which datasets you have access to. API keys can be managed in the [Earthscale Web App](https://app.earthscale.ai) under the user menu (top-right) -> 'API Settings'","title":"Api Key"},"description":"Earthscale API key used to authenticate requests and determine which datasets you have access to. API keys can be managed in the [Earthscale Web App](https://app.earthscale.ai) under the user menu (top-right) -> 'API Settings'"},{"name":"variable","in":"query","required":true,"schema":{"type":"string","description":"Name of the data variable/band to retrieve from the dataset (e.g., 'temperature', 'B4', 'elevation')","title":"Variable"},"description":"Name of the data variable/band to retrieve from the dataset (e.g., 'temperature', 'B4', 'elevation')"},{"name":"dimidx","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Dimension indices","description":"Select a slice from multi-dimensional datasets (e.g., with time or depth axes). Format: 'dimension:index' where index is zero-based. Example: 'time:0' selects the first timestep, 'depth:5' selects the 6th depth level. Repeat for multiple dimensions: ?dimidx=time:0&dimidx=depth:2. Specify all dimensions except the one in the URL path (dim parameter), which will be iterated over to return a series of values"},"description":"Select a slice from multi-dimensional datasets (e.g., with time or depth axes). Format: 'dimension:index' where index is zero-based. Example: 'time:0' selects the first timestep, 'depth:5' selects the 6th depth level. Repeat for multiple dimensions: ?dimidx=time:0&dimidx=depth:2. Specify all dimensions except the one in the URL path (dim parameter), which will be iterated over to return a series of values"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RasterPixelDimensionSeriesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"RasterPixelDimensionSeriesResponse":{"properties":{"dimension":{"type":"string","title":"Dimension"},"dimension_selection":{"additionalProperties":{"type":"integer"},"type":"object","title":"Dimension Selection"},"values":{"anyOf":[{"items":{"anyOf":[{"type":"integer"},{"type":"null"}]},"type":"array"},{"items":{"anyOf":[{"type":"number"},{"type":"null"}]},"type":"array"}],"title":"Values"}},"type":"object","required":["dimension","dimension_selection","values"],"title":"RasterPixelDimensionSeriesResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}
```

## Vector Point Query

> Get vector features at a given location.

```json
{"openapi":"3.1.0","info":{"title":"Earthscale Tiles API v1","version":"1.0.0"},"servers":[{"url":"/v1"}],"paths":{"/vector/{dataset_version_id}/point/{lon}/{lat}":{"get":{"tags":["Queries"],"summary":"Vector Point Query","description":"Get vector features at a given location.","operationId":"Vector_Point_Query_vector__dataset_version_id__point__lon___lat__get","parameters":[{"name":"dataset_version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"UUID of the dataset version to query. Each dataset can have multiple versions representing different states of the data over time","title":"Dataset Version Id"},"description":"UUID of the dataset version to query. Each dataset can have multiple versions representing different states of the data over time"},{"name":"lon","in":"path","required":true,"schema":{"type":"number","description":"Longitude in decimal degrees (-180 to 180, WGS84/EPSG:4326)","title":"Lon"},"description":"Longitude in decimal degrees (-180 to 180, WGS84/EPSG:4326)"},{"name":"lat","in":"path","required":true,"schema":{"type":"number","description":"Latitude in decimal degrees (-90 to 90, WGS84/EPSG:4326)","title":"Lat"},"description":"Latitude in decimal degrees (-90 to 90, WGS84/EPSG:4326)"},{"name":"api_key","in":"query","required":true,"schema":{"type":"string","description":"Earthscale API key used to authenticate requests and determine which datasets you have access to. API keys can be managed in the [Earthscale Web App](https://app.earthscale.ai) under the user menu (top-right) -> 'API Settings'","title":"Api Key"},"description":"Earthscale API key used to authenticate requests and determine which datasets you have access to. API keys can be managed in the [Earthscale Web App](https://app.earthscale.ai) under the user menu (top-right) -> 'API Settings'"},{"name":"zoom","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Map zoom level for fuzzy coordinate matching. When specified, searches within a pixel-sized radius around the coordinates to handle click imprecision. If omitted, returns only exact coordinate matches","title":"Zoom"},"description":"Map zoom level for fuzzy coordinate matching. When specified, searches within a pixel-sized radius around the coordinates to handle click imprecision. If omitted, returns only exact coordinate matches"},{"name":"include_area_in_square_meters","in":"query","required":false,"schema":{"type":"boolean","description":"Calculate and include the geographic area of each feature in square meters using Mollweide equal-area projection. Adds an 'area_m2' property to each feature. Request fails if the dataset already has this column","default":false,"title":"Include Area In Square Meters"},"description":"Calculate and include the geographic area of each feature in square meters using Mollweide equal-area projection. Adds an 'area_m2' property to each feature. Request fails if the dataset already has this column"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","description":"Zero-based page number for paginated results. Each page returns up to 500 items","default":0,"title":"Page"},"description":"Zero-based page number for paginated results. Each page returns up to 500 items"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}
```

## List vector features with bounding boxes

> Get a paginated list of all features in a vector dataset in column-oriented format.\
> The response includes column names, arrays of values (one array per row),\
> feature indices,\
> and bounding boxes (in EPSG:4326).\
> \
> This endpoint is useful for building feature explorer UIs where users can browse\
> all features in a dataset and zoom to individual features using the bounding box.

```json
{"openapi":"3.1.0","info":{"title":"Earthscale Tiles API v1","version":"1.0.0"},"servers":[{"url":"/v1"}],"paths":{"/vector/{dataset_version_id}/features":{"get":{"tags":["Queries"],"summary":"List vector features with bounding boxes","description":"Get a paginated list of all features in a vector dataset in column-oriented format.\nThe response includes column names, arrays of values (one array per row),\nfeature indices,\nand bounding boxes (in EPSG:4326).\n\nThis endpoint is useful for building feature explorer UIs where users can browse\nall features in a dataset and zoom to individual features using the bounding box.","operationId":"Vector_Features_List_vector__dataset_version_id__features_get","parameters":[{"name":"dataset_version_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","description":"UUID of the dataset version to query. Each dataset can have multiple versions representing different states of the data over time","title":"Dataset Version Id"},"description":"UUID of the dataset version to query. Each dataset can have multiple versions representing different states of the data over time"},{"name":"api_key","in":"query","required":true,"schema":{"type":"string","description":"Earthscale API key used to authenticate requests and determine which datasets you have access to. API keys can be managed in the [Earthscale Web App](https://app.earthscale.ai) under the user menu (top-right) -> 'API Settings'","title":"Api Key"},"description":"Earthscale API key used to authenticate requests and determine which datasets you have access to. API keys can be managed in the [Earthscale Web App](https://app.earthscale.ai) under the user menu (top-right) -> 'API Settings'"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Page number (0-indexed). Each page contains up to `page_size` features.","default":0,"title":"Page"},"description":"Page number (0-indexed). Each page contains up to `page_size` features."},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"Number of features per page. Default is 100.","default":100,"title":"Page Size"},"description":"Number of features per page. Default is 100."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.earthscale.ai/http-api/fast-tiler-http-api/queries.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.