> For the complete documentation index, see [llms.txt](https://docs.mapbox.com/api/ja/llms.txt)

# Rasterarray Tiles API

The **Mapbox Rasterarray Tiles API** serves [MRT (Mapbox Raster Tiles)](https://docs.mapbox.com/mapbox-tiling-service/raster/#mapbox-raster-tiles) format tiles generated from raster data processed by the [Mapbox Tiling Service](https://docs.mapbox.com/mapbox-tiling-service/guides/). This API enables access to advanced raster data formats with support for temporal sequences and job-based processing workflows.

## Retrieve rasterarray tiles

**GET** : `https://api.mapbox.com/rasterarrays/v1/{tileset_id}/{zoom}/{x}/{y}.mrt`

| Required parameters | Type | Description |
| --- | --- | --- |
| `tileset_id` | `string` | Unique identifier for the raster tileset in the format `username.id`. |
| `zoom` | `integer` | Specifies the tile's zoom level, as described in the [Slippy Map Tilenames](http://wiki.openstreetmap.org/wiki/Slippy_map_tilenames) specification. |
| `{x}/{y}` | `integer` | Specifies the tile's column `{x}` and row `{y}`, as described in the [Slippy Map Tilenames](http://wiki.openstreetmap.org/wiki/Slippy_map_tilenames) specification. |
| `jobid` | `string` | A unique job identifier that references the specific processing job for the raster data. This is typically returned from the [Raster Tiling Service](https://docs.mapbox.com/mapbox-tiling-service/raster/) when a tileset is processed. Example: `clzbftvx6001908mc5z9hddb9` |
| `access_token` | `string` | A valid Mapbox [access token](https://docs.mapbox.com/api/ja/guides/#access-tokens-and-token-scopes). |

### Example request: Retrieve rasterarray tiles

```bash
# Retrieve an MRT tile with job ID

$ curl "https://api.mapbox.com/rasterarrays/v1/mapbox.gfs-temperature/4/28/1989.mrt?access_token=YOUR_MAPBOX_ACCESS_TOKEN&jobid=clzbftvx6001908mc5z9hddb9"
```

### Response: Retrieve rasterarray tiles

The response is an [MRT (Mapbox Raster Tile)](https://docs.mapbox.com/mapbox-tiling-service/raster/#mapbox-raster-tiles) format file containing the processed raster data. MRT is a binary format optimized for efficient transmission and rendering of raster array data. The response content type is `application/octet-stream`.

For performance, tiles are delivered with appropriate cache headers to optimize client-side and CDN caching.

## Rasterarray Tiles API errors

<table><thead><tr><th>Response body <code>message</code></th><th>HTTP status code</th><th>Description</th></tr></thead><tbody><tr><td><code>Bad Request</code></td><td><code>400</code></td><td>The request is malformed or missing required parameters. Check that all required parameters are provided and properly formatted.</td></tr><tr><td><code>Not Authorized - No Token</code></td><td><code>401</code></td><td>No access token was provided in the query.</td></tr><tr><td><code>Not Authorized - Invalid Token</code></td><td><code>401</code></td><td>The provided access token is invalid or expired. Check the access token you used in the query.</td></tr><tr><td><code>Forbidden</code></td><td><code>403</code></td><td>Access to this resource is not allowed. This may occur if:<br>• Your account doesn't have access to this tileset<br>• There's an issue with your account (check your <a href="https://console.mapbox.com/">Account page</a>)<br>• You're using an access token with URL restrictions that don't match this request</td></tr><tr><td><code>Not Found</code></td><td><code>404</code></td><td>The requested tile does not exist. This may occur if:<br>• The tileset ID doesn't exist<br>• The tile coordinates (z/x/y) are invalid or outside the tileset bounds<br></td></tr><tr><td><code>Zoom level must be between 0-30.</code></td><td><code>422</code></td><td>The zoom level specified in the query is larger than 30 or contains non-numeric characters.</td></tr></tbody></table>

## Rasterarray Tiles API restrictions and limits

-   The default rate limit for the Mapbox Rasterarray Tiles API endpoint is 100,000 requests per minute. もし、レート制限をの数を高くしたい場合は、 [お問い合わせください。](https://www.mapbox.com/contact/sales/).
-   If you exceed the rate limit, you will receive an `HTTP 429 Too Many Requests` response. For information on rate limit headers, see the [Rate limit headers](https://docs.mapbox.com/api/ja/guides/#rate-limit-headers) section.
-   MRT tiles are binary format files that require using Mapbox libraries or SDKs for decoding and rendering.
-   The maximum supported zoom level is 30, though actual available zoom levels depend on the specific tileset and processing parameters.
-   For general information on caching, see the [Maps APIs caching dive deeper guide](https://docs.mapbox.com/help/dive-deeper/api-caching/).