Custom maps
Use a custom style
Image, terrain, and vector layers now come with default styles. These are default sources which provide a way to access Mapbox's rich data. You can select one of the generic Mapbox styles, or select Custom to use a custom style. For a walkthrough on how to configure a custom style, follow the Custom maps style for Unity tutorial.
For image layers, select Custom to use a custom style from Mapbox Studio.
There are two ways to specify a custom style:
- Copy a style URL from your Mapbox Studio account and paste it into the
Idfield of your image factory. - Search for a style linked to your account.
- Note: To search for a style, you may have to generate a new access token with
styles:listscope enabled. If you had to create a new access token, remember to swap it out with the old token in your Mapbox Setup panel.
- Note: To search for a style, you may have to generate a new access token with
After specifying a custom style, the map will render the new style when you play the scene. You can further customize your map style in Mapbox Studio. Note that there may be some differences in color quality and resolution between Mapbox Studio and Unity: this is expected.
"Mapbox Streets With Building IDs" combines Mapbox-Streets-v7 vector data with our experimental 3D buildings data, which assigns unique IDs to building features to avoid visual artifacts for buildings at tile borders.
Use custom data
You can use your own data with a custom tileset using the Maps SDK for Mapbox Unity. To do so, you'll need to first create a dataset and export it to a tileset using Mapbox Studio.
For example: This custom population density tileset contains a layer outgeojson, which contains the properties id, p, and pkm2. The tileset contains the population per square kilometer in the property (pkm2) for all areas of the United States. You can configure your AbstractMap component in the following way to render extrusions of various blocks of a city and visualize that data on a map.
- Right click MAP LAYERS on the AbstractMap component.
- Select Custom for the Data Source
- Enter the tileset IDs
peterqliu.d0vin3elin the Map Id field. Note that you can specify any tileset ID in this field. - Click Add Visualizer to create a new visualizer. Next, name it by clicking Untitled once, specifying a title and pressing
Enter.PopulationDensityis used for this example, but you can name this whatever you want. - In the Vector Layer Visualizer settings, set the
Primitive Typeto Polygon. - Enter
outgeojsonfor the Layer Name. This must match the Layer details for the specified tileset. For this tileset, it isoutgeojson. - Set the Extrusion Type to Property Height.
- Enter
pkm2for the Property Name. This value must equal the name of a property on the specified tileset. For this tileset, it ispkm2. - Change the Texturing Style to Custom, and add a material of your choice to the Top Material and Side Material fields. Note that the
PopulationMatmaterial file is what produces the gradient style seen below. It is from custom code that uses thepkm2value to style the blocks differently. It is not included in the Maps SDK for Unity.
Here’s the output of that configuration when you play the scene. The screenshot below shows the population density of different blocks in San Francisco.