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

# Mapbox Indoor v3

This tileset reference document includes information to help you use the data in the Indoor v3 tileset.

## Overview

**Indoor v3** is a Mapbox-provided vector tileset that includes geometries and metadata for indoor mapping. It contains data about structures (buildings), floors, floorplan elements (rooms, amenities, corridors), doors, and labels for indoor venues such as airports. The initial version of the tileset covers 200+ airports, with coverage expanding over time. Additional venue types will be added in future updates.

### Access this Tileset

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

```text
mapbox://mapbox.indoor-v3
```

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

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

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

```text
https://api.mapbox.com/v4/mapbox.indoor-v3/{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/ja/maps/tilequery/):

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

## Data stability

As we make ongoing data updates to reflect changes in indoor venues, we may also add new layers, fields, and values to the `mapbox.indoor-v3` tileset. You should design your styles to account for the possibility of new field values. While backward compatibility is not guaranteed between versions, it will be a priority as we integrate additional data.

## Data hierarchy

The tileset organizes indoor data in a hierarchical structure:

**Facility - Structure - Floor - Floorplan elements, Doors, Labels**

A **facility** represents a venue such as an airport. Each facility contains one or more **structures** (buildings), each structure contains one or more **floors**, and each floor contains **floorplan elements**, **doors**, and **labels**. Features in each layer reference their parent feature by ID. For example, each facility in `indoor_facility_metadata` has a unique `id` field, and each structure in `indoor_structure` references its parent facility's ID in the `facility_id` field.

| Layer | Parent ID Field | References |
| --- | --- | --- |
| `indoor_structure` | `facility_id` | `indoor_facility_metadata.id` |
| `indoor_floor` | `structure_id` | `indoor_structure.id` |
| `indoor_floorplan`, `indoor_door`, `indoor_label` | `floor_id` | `indoor_floor.id` |

The tileset also includes three **metadata layers** that provide additional attributes and relationships not present in the geometry layers:

-   [`indoor_facility_metadata`](#indoor_facility_metadata) — metadata about facilities (venues).
-   [`indoor_structure_metadata`](#indoor_structure_metadata) — metadata about structures (buildings).
-   [`indoor_floor_metadata`](#indoor_floor_metadata) — metadata about floors, including fields such as `is_default`, `connected_floor_ids`, and `conflicted_floor_ids` that help determine which floors to display.

Metadata layer geometries are simplified shapes (bounding boxes or unions) intended for spatial lookup rather than rendering.

## Layer Reference

The Indoor v3 tileset contains the following layers. All layers are available from zoom level 14 to 18.

| Layer | Min. zoom | Max. zoom |
| --- | --- | --- |
| [`indoor_structure`](#indoor_structure) | 14 | 18 |
| [`indoor_floor`](#indoor_floor) | 14 | 18 |
| [`indoor_floorplan`](#indoor_floorplan) | 14 | 18 |
| [`indoor_door`](#indoor_door) | 14 | 18 |
| [`indoor_label`](#indoor_label) | 14 | 18 |
| [`indoor_facility_metadata`](#indoor_facility_metadata) | 14 | 18 |
| [`indoor_structure_metadata`](#indoor_structure_metadata) | 14 | 18 |
| [`indoor_floor_metadata`](#indoor_floor_metadata) | 14 | 18 |

### `indoor_structure`

min zoom level: 14buffer: 25

The `indoor_structure` layer contains building and structure geometries for indoor-mapped venues.

#### `id` *text*

Unique ID of the structure.

#### `name` *text*

Name of the structure.

#### `shape_type` *text*

The kind of physical structure the feature represents.

| Value | Description |
| --- | --- |
| `building` | A building footprint |

#### `facility_id` *text*

ID of the venue (facility) this structure belongs to.

### `indoor_floor`

min zoom level: 14buffer: 25

The `indoor_floor` layer contains floor geometries within structures.

#### `id` *text*

Unique ID of the floor.

#### `name` *text*

A short identifier for the floor, such as "1", "2A", or "-1".

#### `description` *text*

A human-readable floor name, such as "Level 1" or "Ground Floor". This complements the `name` field which contains a shorter numeric identifier.

#### `z_index` *number*

Display order of the floor. Used to sort floors vertically within a structure.

#### `structure_id` *text*

ID of the structure this floor belongs to.

### `indoor_floorplan`

min zoom level: 14buffer: 25

The `indoor_floorplan` layer contains detailed floorplan elements such as rooms, amenities, corridors, and points of interest within a floor.

#### `id` *text*

Unique ID of the floorplan element.

#### `name` *text*

Name of the floorplan element.

#### `shape_type` *text*

The kind of indoor element the feature represents.

| Value | Description |
| --- | --- |
| `amenity` | A venue amenity such as a lounge, smoking area, or service desk |
| `area` | A general functional area such as a drop-off zone or parking area |
| `carousel` | A baggage carousel |
| `occupant` | A space occupied by a business such as a shop, restaurant, or airline counter |
| `poi` | A point of interest such as an ATM, elevator, or escalator |
| `room` | An enclosed room such as a restroom, office, or storage room |

#### `class` *text*

A high-level classification of the floorplan element.

| Value | Description |
| --- | --- |
| `check-in` | Check-in area |
| `connector` | Connector between areas |
| `corridor` | Corridor or walkway |
| `healthcare` | Healthcare or medical facility |
| `inaccessible` | Inaccessible or restricted area |
| `parking` | Parking area |
| `post_security` | Post-security zone (airside) |
| `pre_security` | Pre-security zone (landside) |
| `restaurants` | Restaurant or food service area |
| `retail` | Retail area |
| `security` | Security checkpoint |
| `services` | General services area |
| `ticketing` | Ticketing area |
| `transportation` | Ground transportation area |
| `travel` | Travel-related area such as gates or lounges |
| `vacant` | Vacant or unoccupied space |
| `venue_services` | Venue operations and services |

#### `type` *text*

A more specific classification of the floorplan element. New values may be added as coverage expands.

```
amenity
animal_relief_area
area
baggage_claim_area
baggage_services
bus_station
chapel/prayer_room
check-in
connector
corridor
customer_services
default
drop_off
experiences
healthcare
inaccessible
information
meditation_room
navigation
parking
pick_up
post_security
prayer_rooms
pre_security
restaurants
retail
ridesharing
security
self_check-in
services
shuttle
sports_and_recreation
ticketing
train
train_station
transit_station
transportation
travel
uncategorized
vacant
venue_services
```

#### `height` *number*

Height of the floorplan element in meters. Can be used for 3D extrusion rendering.

#### `floor_id` *text*

ID of the floor this element belongs to.

#### `z_offset` *number*

Vertical offset from the floor level in meters. Used to position elements above the floor surface in 3D rendering.

### `indoor_door`

min zoom level: 14buffer: 25

The `indoor_door` layer contains door features within indoor venues, including standard doors, external doors, elevator doors, and openings.

#### `id` *text*

Unique ID of the door.

#### `class` *text*

The type of door or opening.

| Value | Description |
| --- | --- |
| `door` | A standard interior door |
| `external_door` | An exterior door |
| `opening` | An opening (no physical door) |
| `inter_building_door` | A door connecting two buildings |
| `elevator_door` | An elevator door |

#### `name` *text*

Name of the door.

#### `icon` *text*

Icon identifier for the door feature. Current values include:

```
external_door
inter_building_door
```

#### `floor_id` *text*

ID of the related floor.

#### `z_offset` *number*

Vertical offset from the floor level in meters. Used to position the door in 3D rendering.

### `indoor_label`

min zoom level: 14buffer: 25

The `indoor_label` layer contains label points for various indoor features including buildings, floors, rooms, amenities, gates, and points of interest.

#### `id` *text*

Unique ID of the label.

#### `name` *text*

Label text to display.

#### `shape_type` *text*

The kind of indoor element the label is associated with.

| Value | Description |
| --- | --- |
| `amenity` | Label for a venue amenity such as a lounge or service desk |
| `area` | Label for a general functional area such as a drop-off zone |
| `building` | Label for a building |
| `carousel` | Label for a baggage carousel |
| `floor` | Label for a floor |
| `gate` | Label for a boarding gate |
| `occupant` | Label for a business such as a shop, restaurant, or airline counter |
| `poi` | Label for a point of interest such as an ATM or elevator |
| `room` | Label for an enclosed room such as a restroom or office |

#### `class` *text*

A high-level classification of the labeled feature. Uses the same values as the `class` field in the [`indoor_floorplan`](#indoor_floorplan-class) layer, plus the following label-specific values:

| Value | Description |
| --- | --- |
| `gate` | Boarding gate |
| `self_check` | Self-check kiosk |
| `wheelchair_assistance` | Wheelchair assistance point |

#### `type` *text*

A granular category of the labeled feature, such as `restrooms`, `gates`, `food_court`, or `baggage_carousels`. Uses the same categorization as the `type` field in the [`indoor_floorplan`](#indoor_floorplan-type) layer.

#### `brand` *text*

Brand name associated with the feature.

#### `icon` *text*

Icon identifier for the feature. New values may be added as coverage expands. Current values include:

```
airport-check-in
atm
bank
bus
cafe
charging-station
elevator
escalator
gate-label
information
lounge
rail-metro
ramp
restaurant
ride-share
security
shop
stairs
suitcase
taxi
toilet
toilet-female
toilet-male
```

#### `floor_id` *text*

ID of the related floor.

#### `z_offset` *number*

Vertical offset from the floor level in meters. Used to position the label in 3D rendering.

### `indoor_facility_metadata`

min zoom level: 14buffer: 25

The `indoor_facility_metadata` layer contains metadata about indoor facilities (venues). Each feature represents a facility and provides identifying information. Feature geometries are bounding boxes of all buildings within the facility.

#### `id` *text*

Unique facility ID.

#### `type` *text*

The type of the metadata feature.

| Value | Description |
| --- | --- |
| `facility` | A facility |

#### `class` *text*

The type of venue. Additional venue types will be added in future updates.

| Value | Description |
| --- | --- |
| `airport` | An airport |

#### `name` *text*

Name of the facility.

#### `description` *text*

An abbreviated name or short identifier for the facility, such as an airport IATA code.

### `indoor_structure_metadata`

min zoom level: 14buffer: 25

The `indoor_structure_metadata` layer contains metadata about structures (buildings) within indoor-mapped venues. Feature geometries are bounding boxes of the building footprints.

#### `id` *text*

Unique ID of the structure.

#### `type` *text*

The type of the metadata feature.

| Value | Description |
| --- | --- |
| `structure` | A building |

#### `name` *text*

Name of the structure.

#### `center_lat` *number*

Latitude of the center of the structure.

#### `center_lon` *number*

Longitude of the center of the structure.

#### `facility_id` *text*

ID of the venue (facility) this structure belongs to.

### `indoor_floor_metadata`

min zoom level: 14buffer: 25

The `indoor_floor_metadata` layer contains metadata about floors within structures. This includes information about floor ordering, height, default display state, and relationships to other floors and structures. Feature geometries are unions of floor polygons per building.

#### `id` *text*

Unique ID of the floor.

#### `name` *text*

A short identifier for the floor, such as "1", "2A", or "-1".

#### `description` *text*

A human-readable floor name, such as "Level 1" or "Ground Floor". This complements the `name` field which contains a shorter numeric identifier.

#### `type` *text*

The type of the metadata feature.

| Value | Description |
| --- | --- |
| `floor` | A floor |

#### `height` *number*

Height of the floor in meters. Can be used for 3D extrusion rendering.

#### `z_index` *number*

Display order of the floor. Used to sort floors vertically within a structure.

#### `is_default` *boolean*

Whether the floor is displayed by default when the venue is first shown. The default floor is the one with the lowest non-negative `z_index` in the building.

#### `structure_ids` *text*

Related building ID values, delimited by the `;` character.

#### `conflicted_floor_ids` *text*

Conflicted floor ID values, delimited by the `;` character. Conflicted floors are those that overlap spatially and should not be displayed simultaneously.

#### `connected_floor_ids` *text*

Connected floor ID values, delimited by the `;` character. Connected floors are those that are linked (for example via connectors) and may be displayed together.

#### `ground_z_offset` *number*

Offset from the ground level in meters.