Mapbox Indoor v1
This tileset reference document includes information to help you use the data in the Mapbox Indoor v1 tileset.
Overview
Mapbox Indoor v1 is a Mapbox-provided vector tileset that provides floor plans and points of interests inside buildings. It can be used independently or together with the Mapbox Streets v8 tileset.
Data sources & updates
This tileset includes data only for Japan. It uses data from Zenrin and is updated with each new Zenrin data release, approximately every 3 months.
When you publicly use styles or software that use Mapbox Indoor vector tiles, you must display proper attribution.
The current supported version of the Mapbox Indoor vector tiles receives regular data updates as new information becomes available and existing information is improved.
Data stability
As we make ongoing data updates to reflect changes in the world or integrate new data vendors, we may also add new layers, fields, and values to Mapbox Indoor 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 Indoor v1 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 or reflect real-world changes.
- New values may be added to any field unless otherwise noted in this documentation.
Common fields
There are several fields that are used across several layers. These fields are detailed below instead of being duplicated for each relevant layer in the Layer reference section.
name
text and name_<lang-code>
text
Label names are available in many languages. The name_*
value is null
if no translation data is available for a given feature.
If the name
field is null for a particular feature, then all the language-specific name_*
fields is also null. This means that name
should always be the final fallback value if you want to include it in your set of label languages.
If the name
field contains text to be rendered on multiple lines (horizontally or vertically) the text is separated by zero-width space characters.
Field | Description |
---|---|
name | The name (or names) used locally for the place. |
name_ja | Japanese |
name_script
text
Wherever there is a name
field, there is also a name_script
field that describes the primary script used in that text. This can be helpful for customizing fonts or language fallback conditions. Values include:
Han
Hiragana
Katakana
Latin
The value is null if name is also null.
maki
text
Some layers have a maki
field designed to make it easier to assign icons using the Maki icon project or other icons that follow the same naming scheme. Note that not all icons from the Maki project are used in Mapbox Indoor. Each layer uses a different subset of the names, but the full list of values used in Mapbox Indoor is compiled here so you can make sure your style has all the icons needed across different layers.
indoor_poi_label
:
bank
cafe
car-rental
clothing-store
convenience
fast-food
furniture
grocery
ice-cream
information
junction
marker
mobile-phone
parking
pharmacy
police
post
restaurant
restaurant-noodle
shoe
shop
suitcase
toilet
indoor_structure
:
defibrillator
emergency-phone
marker
telephone
waste-basket
maki_beta
text
Maki icons that might be supported in future versions of Mapbox Indoor are in maki_beta
field. Possible values include, but are not limited to:
indoor_poi_label
:
atm
mall
restaurant-casual
restaurant-sushi
smoking
station-office
ticket
toilet-female
toilet-male
indoor_structure
:
arrow
bench
elevator
entrance
escalator
locker
moving-walkway
platform
ramp
ticket
turnstile
vending-machine
maki_modifier
text
Localized Maki icons are enabled with the maki_modifier
field. The value of maki_modifer
corresponds to an ISO country code. If it's present on a feature, you can use it to swap out a default Maki icon with a country-specific one.
For example, the widely recognized symbol for banks in Japan is different than that for the US. In the indoor_poi_label
layer, all features that represent banks have a maki
field with value bank
. Of those features, the ones located in Japan also have a maki_modifer
field with a value of JP
. This allows you to specify the bank-JP
Maki icon rather than the bank
icon when styling your map.
floor_id
number {#floor_id-number}
Floor number is a sequence number for a floor; for example, -1, 0, 1, 2, 3, 4.
Note that a floor_id
of 0 does not necessarily mean ground floor (consider a building built on a slope). Mezzanine floors are also represented by an integer value.
floor_level
text {#floor_level-text}
Floor level is the abbreviated name of a floor; for example: B1F, MB1F, 1F, M2F.
facility_id
text {#facility_id-text}
Unique ID of a facility. All features in the same facility has the same facility_id
, regardless of which floor they are on.
Note that a facility is not equivalent to a building. For example, a building can host a train station above ground and an underground mall, in which case the train station is one facility and the mall is another facility.
Layer Reference
The Mapbox Indoor v1 tileset contains the following layers. For reference, the current minimum-available zoom level for each layer is mentioned, but note that this is subject to change as we make updates and improvements. It also does not apply to all features within a layer. Only the most prominent features are available at lower-numbered zoom levels, and more features are available as you zoom in. Labels for physically-large features also have a maximum zoom level based on their size.
Layer | Min. zoom level |
---|---|
indoor_floorplan | 15 |
indoor_poi_label | 15 |
indoor_structure | 15 |
indoor_floorplan
This layer contains the polygon footprint of stores, corridors, common areas, floors and facilities in a building.
A floor polygon is the aggregation of all stores, corridors, and common area polygons on the same floor in the same facility. (Note that a facility is not necessarily equivalent to a building.)
A facility polygon is the aggregation of all floor polygons in the same facility.
Here's a list of fields in the indoor_floorplan
layer:
Field | Data type | Nullable | Description |
---|---|---|---|
class | text | No | Mapbox class that describes the purpose of the space inside the polygon. |
type | text | Yes | Mapbox type that describes the purpose of the space inside the polygon. |
facility_id | text | No | Unique ID of a facility. |
floor_id | number | Yes | Floor level in integer; null for facility polygons. |
floor_level | text | Yes | Floor level abbreviation; null for facility polygons. |
class
text {#class-text}
Indoor floorplan class
values include but are not limited to:
area
arts_and_entertainment
commercial_services
facility
floor
food_and_drink
food_and_drink_stores
landmark
medical
public_facilities
room
store_like
visitor_amenities
type
text {#type-text}
Indoor floorplan type
values include but are not limited to:
Amusement arcade
Area
Atm
Bank
Beauty
Books
Bureau de change
Cafe
Car rental
Childcare
Clothes
Convenience
Courier
Electronics
Fast food
Fountain
Furniture
Greengrocer
Ice cream
Information
Juice bar
Key cutter
Kiosk
Lost and found
Massage
Mobile phone
Office
Pharmacy
Photo booth
Platform
Police
Post office
Ramen
Rental
Restaurant
Restricted
Room
Shoes
Shop
Smoking area
Soba
Sports
Staff
Supermarket
Ticket
Toilets
Waiting room
Facility
Floor
indoor_poi_label
This layer is used to place icons and labels for various points of interest (POIs). This layer includes centroid point(s) of every floor of a facility as well as the centroid of the entire facility as a whole.
See names
and name_script
in for information about names and translations available for label text.
See maki
and maki_beta
for more information about using these fields for assigning icons.
Here's a list of fields in the indoor_poi_label
layer:
Field | Data type | Nullable | Description |
---|---|---|---|
class | text | No | Mapbox class that describes the content of the polygon. |
type | text | Yes | Mapbox type that describes the content of the polygon. |
brand | text | Yes | Standardized brand name for chain stores. |
name | text | Yes | Name label. |
name_ja | text | Yes | Name in Japanese. |
name_script | text | Yes | Primary script for name attribute. |
maki | text | Yes | Maki icon value. See maki . |
maki_beta | text | Yes | Maki icons that might be supported in future versions of Mapbox Indoor. See maki_beta . |
maki_modifier | text | Yes | Region modifier for Maki icon. See maki_modifier . |
source_id | text | Yes | Unique ID of a POI. |
facility_id | text | No | Unique ID of a facility. |
floor_id | number | Yes | Floor level in integer; null for facility polygons. |
floor_level | text | Yes | Floor level abbreviation; null for facility polygons. |
class
text {#indoor_poi_label-class-text}
Indoor POI class
values include but are not limited to:
arts_and_entertainment
building
commercial_services
food_and_drink
food_and_drink_stores
landmark
medical
motorist
public_facilities
room
store_like
visitor_amenities
type
text {#indoor_poi_label-type-text}
Indoor POI type
values include but are not limited to:
Amusement arcade
Atm
Bank
Beauty
Books
Bureau de change
Cafe
Car rental
Childcare
Clothes
Convenience
Courier
Electronics
Fast food
Furniture
Greengrocer
Ice cream
Information
Juice bar
Key cutter
Kiosk
Lost and found
Mall
Massage
Mobile phone
Office
Parking
Pharmacy
Photo booth
Police
Post office
Ramen
Rental
Restaurant
Shoes
Shop
Smoking area
Soba
Sports
Supermarket
Ticket
Toilets
Waiting room
brand
text {#indoor_poi_label-brand-text}
Indoor POI brand
values include but are not limited to all brand values in Mapbox Streets V8 and the following:
kiosk
metros
midori-no-madoguchi
newdays
source_id
text {#indoor_poi_label-source_id-text}
An indoor POI's source_id
is a unique ID created by concatenating Zenrin's prefecture code, industry code, and sequence number. source_id
is not guaranteed to be stable.
indoor_structure
This layer includes points, lines, and polygons for features such as coin lockers, ticket machines, elevators, wall, signage, etc.
The fields in the indoor_structure
layer are:
Field | Data type | Nullable | Description |
---|---|---|---|
class | text | No | Mapbox class that describes the content of the polygon. |
type | text | Yes | Mapbox type that describes the content of the polygon. |
name | text | Yes | Name label. |
name_ja | text | Yes | Name in Japanese. |
name_script | text | Yes | Primary script for name attribute. |
maki | text | Yes | Maki icon value. See maki . |
maki_beta | text | Yes | Maki icons that might be supported in future versions of Mapbox Indoor. See maki_beta . |
maki_modifier | text | Yes | Region modifier for Maki See maki_modifier . |
direction | number | Yes | Angle of rotation for an arrow. |
source_id | text | Yes | Unique ID of a point feature. |
facility_id | text | No | Unique ID of a facility. |
floor_id | number | Yes | Floor level in integer; null for facility polygons. |
floor_level | text | Yes | Floor level abbreviation; null for facility polygons. |
class
text {#indoor_structure-class-text}
Indoor structure class
values include but are not limited to:
area
commercial_services
corridor
door
general
railway
road
room
visitor_amenities
wall
type
text {#indoor_structure-type-text}
Indoor structure type
values include but are not limited to:
Bench
Corridor
Defibrillator
Elevator
Entrance
Escalator
Exit
Help point
Locker
Moving walkway
Phone
Platform
Public transport tickets
Rail
Ramp
Road
Steps
Tactile map
Telephone
Turnstile
Vending machine
Wall
Waste basket
direction
text {#indoor_structure-direction-text}
An integer between 0 degrees and 359 degrees for rotating an arrow icon.
direction | Arrow Orientation |
---|---|
0 | Arrow points to the left (east) |
90 | Arrow points to the bottom (south) |
180 | Arrow points to the right (west) |
270 | Arrow points to the top (north) |
To use the direction
value to rotate an icon in Mapbox Studio, the formula is:
["get", "direction"]
source_id
text {#indoor_structure-source_id-text}
source_id
is a unique ID created by concatenating Zenrin's prefecture code, industry code, and sequence number. source_id
is not guaranteed to be stable. Only point structures can have a source_id
.