# Tile service

This endpoint provides the recommended way to render raster data in your apps. Mind that your mapping library will fill in the z, x and y parameters. You can pass both a style id as well as a custom style object. Click [here](/developers/api-v3/path-raster/styles.md) to see how to define a style object.

| **Description** | Retrieves tiff file of the given raster or a png file of the styled raster.    |
| --------------- | ------------------------------------------------------------------------------ |
| **Endpoint**    | `/path/{pathId}/raster/timestamp/{timestampId}/tile/{z}/{x}/{y}?token={token}` |
| **Method**      | GET                                                                            |

### Access Level Rules

| **Minimum Access Level** | view |
| ------------------------ | ---- |

### Processing Units

| **Minimum processing units** | 1 |
| ---------------------------- | - |

{% hint style="info" %}
In case you wish to create visualizations of multiple raster layers in Ellipsis Drive use the stack endpoint that you can find [here](https://docs.ellipsis-drive.com/developers/api-v3/path-raster/timestamps/stack-rasters).
{% endhint %}

## Parameters

<table><thead><tr><th width="354">Name</th><th width="212">Description</th><th width="135">Required</th><th>Default</th></tr></thead><tbody><tr><td><code>pathId</code></td><td>The id of the raster layer.</td><td>true</td><td></td></tr><tr><td><code>timestampId</code></td><td>The id of the timestamp.</td><td>true</td><td></td></tr><tr><td>x</td><td>The x coordinate of the tile.</td><td>true</td><td></td></tr><tr><td>y</td><td>The y coordinate of the tile.</td><td>true</td><td></td></tr><tr><td>z</td><td>The zoom level of the tile.</td><td>true</td><td></td></tr><tr><td><code>style</code></td><td>An id of a style to apply or an object describing a valid style. <strong>If not given original raster values are returned in tif format.</strong><br><br>Valid object for style can be found here: <a href="https://docs.ellipsis-drive.com/developers/api-v3/path-raster/styles/add-style">https://docs.ellipsis-drive.com/developers/api-v3/path-raster/styles/add-style</a></td><td>false</td><td>Default null.</td></tr><tr><td><code>token</code></td><td>User’s login token. </td><td>false, a token can alternatively also be passed in through the authorization header</td><td>Default null.</td></tr><tr><td><code>mask</code></td><td>A geojson polygon in wgs84 coordinates to mask the tileService.</td><td>false</td><td>Default null.</td></tr><tr><td><code>applyStyle</code></td><td>Boolean indicating whether to style the tile. If true a PNG is returned, else the style is ignored and a tiff file is returned instead.</td><td>false</td><td>Default true.</td></tr><tr><td><code>epsg</code></td><td>Integer representing the epsg of the alternative crs to use. Default is web mercator.</td><td>false</td><td>Default 3857.</td></tr></tbody></table>


---

# 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.ellipsis-drive.com/developers/api-v3/path-raster/timestamps/tile-service.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.