CleverMaps provides many ready-to-use geographic dimensions such as administrative units or H3 grids. But sometimes you may need to use your own geographic data - e.g. road segments, buildings or sales areas. This tutorial describes how to import such a custom geographic data into the CleverMaps.

CleverMaps uses vector tiles technology to render geographic data on a map. Currently we use Mapbox as a backend service for hosting and serving vector tiles but other technologies can be also used (e.g. MapTiler). Some further information about vector tiles can be found here

Mapbox account

(warning) This tutorial assumes that you have your own Mapbox account ready. Mapbox has very generous free pricing plan and it should be enough for many use cases. More information about pricing is here . Free account can be created here .

Steps overview

To transform your geographic data (SHP, GeoJSON, CSV, …) into the CleverMaps you typically need to:

  1. create vector tileset at Mapbox

  2. create datasets in CleverMaps:

More information about CleverMaps datasets types can be found here Datasets

1. Creating vector tileset at Mapbox

You have two options for creating a vector tiles from your geodata files (SHP, GeoJSON, CSV…) - using Mapbox Studio or CleverMaps tool MapboxUtils.

Using Mapbox Studio

Using CleverMaps tool MapboxUtils

(warning) Things to keep in mind:

2. Creating datasets in CleverMaps

Now we need to create some tables and metadata JSON files in CleverMaps. As described earlier we need to create two datasets at CleverMaps:

To create these two datasets please follow the instructions here Datasets. Some more things to keep in mind: