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:
mapbox://mapbox.indoor-v3
Access this tileset's TileJSON:
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 using the following template:
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://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— metadata about facilities (venues).indoor_structure_metadata— metadata about structures (buildings).indoor_floor_metadata— metadata about floors, including fields such asis_default,connected_floor_ids, andconflicted_floor_idsthat 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 | 14 | 18 |
indoor_floor | 14 | 18 |
indoor_floorplan | 14 | 18 |
indoor_door | 14 | 18 |
indoor_label | 14 | 18 |
indoor_facility_metadata | 14 | 18 |
indoor_structure_metadata | 14 | 18 |
indoor_floor_metadata | 14 | 18 |
indoor_structure
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
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
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
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
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 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 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
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
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
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.