How to host your map in Amazon S3 cloud

MapTiler Engine supports not only creating map-ready tiles from your data, but also direct upload to a cloud hosting service of your choice. We recommend hosting in MapTiler Cloud which provides fast access and convenient integration with our professional basemaps, but if you still prefer your Amazon S3 service, we make it possible: MapTiler Engine generates your map tiles, uploads them to cloud, and puts them in a folder structure ready to serve your maps.

Please note that upload to 3rd party cloud services (Amazon, Google, Azure) isn't currently available on Windows. Want this feature? Drop us a note.

This page explains how to prepare, upload, and manage your tiles in the Amazon cloud using the MapTiler Engine GUI. To use CLI instead, check out the CloudPush CLI utility.

Before you start

  • Make sure that your MapTiler Engine license includes cloud upload—see the features & pricing table.
  • Prepare your Amazon S3 bucket. MapTiler Engine only supports upload to an existing bucket, which must have Object Ownership set to ACLs enabled and Block Public Access switched off. Please note that these values are different from the default bucket settings recommended by Amazon and you need to set them manually in your Amazon S3 console. It is possible to host multiple maps in one bucket.

Prepare your tileset

  1. Open MapTiler Engine and upload the file(s) you want to tile. Georeference them and set the coordinate system if needed.
  2. On the Output format screen, select MBTiles or GeoPackage. These formats create a single-file tileset which can be conveniently uploaded to cloud.
  3. On the Output settings screen, the config depends on the output format selected in the previous step:
    • For MBTiles, you don’t need to change anything.
    • For GeoPackage, open the Advanced settings and check the MBTiles compatibility box. This setting is mandatory. If you don’t use it, the upload won’t work.

    MBTiles-compatibility setting

  4. On the Upload options screen, select Upload to cloud.
  5. On the Amazon upload screen, fill in your Amazon access key and secret key, your bucket’s name (the bucket must already exist and be set as described in section Before you start) and set its region. You’ll get all these details in your Amazon S3 console.

    Upload to Amazon cloud

MapTiler Engine then starts uploading your tileset and you’ll see the progress on screen.

Preview the tiles

The upload populates your Amazon S3 bucket with a file structure ready to serve your map. The index.html file opens a preview of your map tiles and lists multiple options how to integrate them in a map on your website, or how to open them in GIS tools.

You can access and manage the uploaded files either via your Amazon S3 console, or directly from the finished task screen in MapTiler Engine via menu Options > Open in cloud.

Preview tiles in Amazon cloud