Host and use your image data

MapTiler provides hosting for your map data of any size and type. You can integrate it with a map and serve to your audience without having to manage the hosting infrastructure. This page explains how to prepare, host, and use raster geodata (images). For vector data, see how to edit custom vector data.

Prepare your image

Although it is possible to add an image to a map directly, in most cases, it’s practical to turn it into a special map-ready format. This preparation is called geoprocessing and it cuts your image into a set of raster map tiles. Here’s how to do it:

  1. Upload your image to your MapTiler account.

  2. Georeference your image. This step is only required if we don’t find any location metadata (coordinates) in the image.

  3. When georeferenced, we automatically cut your image into map tiles. You’ll find your new tileset on page Tiles.

Note that there are format and size limits for the upload. If your image data doesn’t comply, or you just prefer to use your own hardware, check out MapTiler Engine for processing virtually any type or volume of data on-prem.

Add your image to map

Now that your image is ready in your MapTiler account, you can proceed to showing it on a map. Select your preferred way, with or without code:

Add image to map programmatically

A convenient option for developers is to use the MapTiler SDK JS. To get the code, go to the example Add a raster tile source. Don’t forget you’ll need a MapTiler API key for the code to work.

Add image in visual editor

For a no-code approach, use our visual map editor Map Designer. Here’s the steps:

  1. Go to page Maps in your MapTiler account and click on New map.

  2. Select a map you’d like to use and click Customize. This takes you to the map editor.

  3. In the left menu panel, go to Data sources and add a new map data source using the plus button. From a list of all available data sources, select your raster tileset.

  4. The data source is now associated with the map, but not actually used yet. Go to Layers and add a new map layer. You’ll get a list of data sources to choose from, including the one you added in the previous step. Select the layer in the source (there will be just one raster layer) and add it to the map. If you don’t see the image on the map now, make sure you’re in the right place and on the right zoom level.

    Ebedding raster tiles in your map

  5. By default, the image layer gets added on top of the map. If you want to display some of the map features over your image, switch from the Blocks to Verticality view and reorder the layers, so that the desired features get on top.

  6. Once you’re happy with the result, save and publish your map. Publishing means that the map is ready to be shared with the world, but it’s not actually visible to anyone unless you take further steps to use the map on a website or in your app.