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

# Mapbox Bathymetry v2

This tileset reference document includes information to help you use the data in the Mapbox Bathymetry v2 tileset.

## Overview

**Mapbox Bathymetry v2** is a vector tileset that provides underwater depth of sea floor at discrete minimum depth levels. The purpose of this tileset is to add ocean detail at low zoom levels. It can be used independently or together with the [Mapbox Streets v8](https://docs.mapbox.com/data/tilesets/reference/mapbox-streets-v8/) tileset.

### Access this Tileset

Use this **Tileset URL** to add this tileset to your map style as a `vector` source:

```text
mapbox://mapbox.mapbox-bathymetry-v2
```

Access this tileset's [TileJSON](https://docs.mapbox.com/help/glossary/tilejson/):

```text
https://api.mapbox.com/v4/mapbox.mapbox-bathymetry-v2.json?access_token=YOUR_MAPBOX_ACCESS_TOKEN
```

Access tiles from this tileset via the [Vector Tiles API](https://docs.mapbox.com/api/maps/vector-tiles/) using the following template:

```text
https://api.mapbox.com/v4/mapbox.mapbox-bathymetry-v2/{z}/{x}/{y}.{format}?access_token=YOUR_MAPBOX_ACCESS_TOKEN
```

Query this tileset at a specific location using the [Tilequery API](https://docs.mapbox.com/api/maps/tilequery/):

```text
https://api.mapbox.com/v4/mapbox.mapbox-bathymetry-v2/tilequery/{longitude},{latitude}.json?access_token=YOUR_MAPBOX_ACCESS_TOKEN
```

### Data source

This tileset uses data from [GEBCO Gridded Bathymetry Data](https://www.gebco.net/data-products/gridded-bathymetry-data).

### Data stability

We may also add new layers, fields, and values to Mapbox Bathymetry tiles. Our goal is to do this in a way that preserves compatibility with existing styles. Here's what you need to know about how Mapbox Bathymetry v2 may change in the future:

-   Layers
    -   Existing layers will not be renamed or removed.
    -   New layers may be added.
-   Fields
    -   Existing fields will not be renamed or removed.
    -   New fields may be added to any layer.
-   Field values
    -   The meanings of existing values will not change.
    -   Values of specific features may change to correct errors.
    -   New values may be added to any field unless otherwise noted in this documentation.

## Layer Reference

The Mapbox Bathymetry v2 tileset contains the following layers:

| Layer | Min. zoom level | Max. zoom level |
| --- | --- | --- |
| [`depth`](#depth) | 0 | 7 |

### `depth`

min zoom level: 13buffer: 2

This layer contains isobath (depth contour) polygons.

Here's a list of fields in the `depth` layer:

| Field | Data type | Nullable | Description |
| --- | --- | --- | --- |
| `min_depth` | *number* | No | Depth of the isobath polygon. All points inside the polygon have a depth less than the `min_depth` value of the polygon. |