Export Map

Studio makes it easy to export your maps in a variety of formats. This guide describes how to:

All exported formats are delivered to you as a downloadable file and must be saved to your local disk.

Click the Export button to open the Export Menu.

Export Map

The Export Map window.

The Export Map window.

You can export the current map as a JSON file. Using this feature, you can either load the map programmatically or import it back into Studio.

The JSON file includes both:

  • A dataset object, containing processed data to render your map.
  • A configuration object, containing the current layer, filter, map style, and interaction settings.

Follow these steps to export your map:

  1. In the Export Menu, click Export Map.
  2. Click Export to generate the JSON file.

Note: Studio's map configuration is connected to datasets. The dataId key is used to bind layers, filters, and tooltip settings to a specific dataset. If you attempt to upload a configuration with a dataset in your own Studio app, ensure that your dataset id matches the dataId in the configuration.

Export Image

The Export Image window.

The Export Image window.

You can export your map as an image in PNG format. You can edit the JSON in viewport config and apply it to the exported image which will update to match the new state defined in the JSON. The underlying Studio map state does not change.

Follow these steps to export your map as an image:

  1. Move your viewport to the area of the map you want to capture.
  2. In the Export Menu, click Export Image.
  3. Select the resolution, ratio, then add or exclude a map legend.
  4. Optionally, edit the JSON in viewport config and apply changes.
  5. Click Download to complete the export.

Export Video

If your visualization has a time filter or a trip layer animation, you can export your map as a video.

An example of a video exported from Studio.

An example of a video exported from Studio.

Click the Export Video button to generate your video. You can find this button in several places, including:

After clicking the Export Video button, the Export Video window appears.

Export Video window.

Export Video window.

This window contains two tabs, including:

  • The Animation tab, where you can reposition the map, change the video's duration, and add camera effects.

    • Supported camera effects include Orbit (90°, 180°, or 360°) and Zoom (in or out).
  • The Settings tab, where you can name your video, select a format, and configure the video's aspect ratio and quality.

    • Supported formats include GIF, WebM, PNG Sequence, and JPEG Sequence.

    • Supported aspect ratios include 16:9 and 4:3.

    • Supported qualities include:

      • Good (540p), High (720p), and Highest (1080p) for 16:9 aspect ratio.

      • Good (480p), High (960p), and Highest (1440p) for 4:3 aspect ratio.

Note: Your video's file size will vary depending on the duration, format, and quality selected.

Export Video Settings tab.

Export Video Settings tab.

Click the play button to see a preview of your map. Click and drag to change the map's frame, and scroll to zoom in and out.

Click Render when you are ready to export.

To recap, follow these steps to export your animated map as a video:

  1. Click the Export Video button.
  2. In the Animation tab, select your desired duration and camera effects.
  3. In the Settings tab, select your desired format, aspect ratio, and quality.
  4. If needed, adjust your frame in the preview window.
  5. Click Render to complete the export.