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

# Mapbox Transit v2

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

## Overview

**Mapbox Transit** is a Mapbox-provided vector tileset includes transit-related features. It can be used to complement the [Mapbox Streets v8](https://docs.mapbox.com/data/tilesets/reference/mapbox-streets-v8/) tileset with data specific to Japan.

### Access this Tileset

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

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

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

```text
https://api.mapbox.com/v4/mapbox.transit-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.transit-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.transit-v2/tilequery/{longitude},{latitude}.json?access_token=YOUR_MAPBOX_ACCESS_TOKEN
```

### Data sources & updates

**This tileset includes data only for Japan.** It uses data from [Zenrin](https://www.zenrin-datacom.net/en/index.html) and is updated with each new Zenrin data release, approximately every 3 months.

## Data stability

As we make ongoing data updates to reflect changes in the world, we may also add new layers, fields, and values to the `mapbox.transit-v2` tileset. While backward compatibility is not guaranteed between versions, it will be a top priority as we integrate additional data.

## Layer Reference

### `transit_line`

buffer: 1.5

The transit line layer contains metro and other train routes of a geography, with information specific to creating a transit map style. This is different from railway features that appear in the `road` layer, which represent physical railroad tracks.

See [`names`](https://docs.mapbox.com/data/tilesets/reference/mapbox-streets-v8#names) and [`name_script`](https://docs.mapbox.com/data/tilesets/reference/mapbox-streets-v8#name_script) in for information about names and translations available for label text.

#### `line_color` *text*

A CSS [extended color keyword](https://www.w3.org/wiki/CSS/Properties/color/keywords) of the color with which to style the route. The color aligns with colors set by the operator.

```
brown
tan
gray
pink
teal
violet
turquoise
darkblue
purple
darkorange
yellow
mediumpurple
cyan
mediumblue
lime
darkgreen
lightblue
green
blue
red
orange
```

#### `len` *number*

The `len` field stores the length of the line segment in projected meters, rounded to the nearest whole number.

#### `mode` *text*

One of the GTFS [extended route types](https://developers.google.com/transit/gtfs/reference/extended-route-types) that best categorizes the type of service on the line.

Some examples include:

```
freight
funicular
aerialway
monorail
tram
metro_rail
high_speed_rail
regional_rail
inter_regional_rail
```

#### `network` *text*

Contains the name of the transportation network.

Some examples include:

```

saitama-high-speed-rail
fukuoka-city-subway
kyoto-municipal-subway
sendai-subway
sapporo-municipal-subway
kobe-municipal-subway
nagoya-municipal-subway
yokohama-municipal-subway
osaka-metro
toei-subway
tokyo-metro
jr-shikoku
jr-hokkaido
jr-west
jr-kyushu
shinkansen
jr-central
jr-east

```

#### `operator` *text*

Contains the name of the operator (as in the company or organization that manages the transportation network).

Some examples include:

```
fukuoka-city-transportation-bureau
kyoto-municipal-transportation-bureau
sendai-city-transportation-bureau
sapporo-city-transportation-bureau
kobe-city-transportation-bureau
nagoya-transportation-bureau
yokohama-city-transportation-bureau
osaka-metro
toei-transportation
tokyo-metro
jr-shikoku
jr-hokkaido
jr-kyushu
jr-west
jr-central
jr-east
private
```