How to prepare data for a custom 3D globe

This article will show you how to prepare map data with MapTiler Engine so that you can use it to create a custom 3D online globe.

Source data

The easiest way to create an online 3D globe from an image is to prepare the texture of the whole world. The image needs to have a 2:1 aspect ratio to account for 360 degrees of longitude and 180 degrees of latitude in total. In this tutorial, we’ll use the “Cassini Terrestrial and Celestial Globes 1790 - 1792” dataset from David Ramsey’s website.

Rendering the map with MapTiler Engine

First, open MapTiler Engine and simply drag and drop the image into the application window.

mte-select-workflow-clean.png

In most cases, the file should contain the geolocation metadata that MapTiler Engine will automatically parse. If that’s the case, you can proceed by clicking the “CONTINUE” button. However, if your source data do not contain the geolocation information, you’ll see the “No coordinates” or “No geolocation” values in the menu located in the right-hand side of the window. If that happens, choose the coordinate system from the “Coordinates” menu. Most probably, you’ll want to use the WGS84 coordinate system, which can be chosen directly from the drop-down menu.

Then, set the correct geolocation for your image. To cover the whole world, choose the “Bounding box” option from the “Geolocation” menu and input the values: -180 -90 180 90.

Next, proceed click the “CONTINUE” button and choose the output format for your map. If you’re not sure which one to choose, please refer to this documentation article.

mte-output-format-page-gpkg.png

Clicking the “CONTINUE” button will take you to the page, where you can change the settings like the zoom levels or the tile format. The default values suggested by MapTiler Engine should give satisfying results, but you can change them if you need to.

mte-otput-settings.png

Click the “CONTINUE” button to continue to the upload setup.

Publishing the map online

The next step of the process is to put the created map online. You can easily upload the tiles to MapTiler Cloud or any S3-compatible storage service directly from the MapTiler Engine application. In this tutorial, we’ll use the MapTiler Cloud service as it’s probably the most straightforward way.

At upload selection, choose the “Upload to MapTiler Cloud” option and click “CONTINUE”. 

mte-upload-options-maptiler.png

And then fill in the title for your uploaded tileset and click on the “CONTINUE” button.

upload-settings-maptiler-brno.png

When the processing finishes, you’ll see the “OPEN IN CLOUD” button on the bottom panel of the final preview page. It will take you to your MapTiler Cloud account in the web browser. Since you are logged in to your MapTiler Cloud account at this point, your API key will automatically appear in our code examples.

Now you have a source code for globe with you own texture. Go to https://docs.maptiler.com/cesium/ and follow the instructions to build your 3D globe.

Coordinate reference systems
Choosing the output format for your map
How to upload a tileset to MapTiler Cloud

On this page