beginner
No code
Add points to a web map, part 1: create a dataset

This tutorial is the first in a series of tutorials that will teach you how to add points to a map using the Mapbox Studio dataset editor, the Mapbox Studio style editor, and Mapbox GL JS.

Part 1 of the series focuses on the Mapbox Studio dataset editor. In this tutorial, you will learn how to:

  • Upload geospatial data as a dataset
  • Draw additional data in the dataset editor
  • Save and export your dataset as a tileset

View the finished map.

Getting started

There are a few resources you will need in order to follow along with this guide:

  • Mapbox account. Sign up for free at mapbox.com/sign-up.
  • Data. Download this GeoJSON file, which includes the coordinates and feature properties for nine different Chicago Parks.

Download GeoJSON

Upload a new dataset

You can store an editable version of your data in your Mapbox account by uploading it to Mapbox Studio as a dataset. Having an editable version of your data means that you can add, remove, and edit features (points, lines, and polygons) and properties for each feature.

Create a dataset

  1. Log into Mapbox Studio and navigate to the Datasets page.
  2. Click the New dataset button.
  3. Select the Upload option in the upper right corner of the New Dataset modal.
  4. Select the GeoJSON you just downloaded. Click Confirm, then click Create. Screenshot illustrating how to create a dataset in Mapbox Studio
  5. Once your file has completed uploading, click Start editing. The dataset editor automatically opens, and the data is displayed on a dark base map to help visualize the features.

Screenshot showing the Mapbox Studio dataset editor

About datasets

You can edit both dataset features and properties in the dataset editor:

  • Features are the points, lines, and polygons on your map. You can add new features using the draw tools, edit the placement or shape of features using by clicking and dragging features on the map, or remove features all together by clicking on them and hitting the delete key. You can also click on each feature in the dataset editor to view its properties.
  • Properties can be strings, numbers, or booleans. In the sample dataset you uploaded, there are title and description properties for each point with a unique text string. You can edit properties, add new properties, or delete properties in the dataset editor. Make sure any content that you want to display in popups in your final product is included as a property while you are working in the dataset editor.

Draw data

You can use the draw tools in the dataset editor to add a new point to your dataset. You can also modify the geometry, placement, and properties of existing features with the dataset editor’s draw tools. Read more about draw tools in the Mapbox Studio manual.

Draw a new feature

  1. Click inside the Search places field in the upper right side of the editor and search for Garfield Park Chicago.
  2. Use the draw tool to create a new point on the map at that location.
  3. Next, click the Add Property button. Use the properties list on the left side of the screen to add the following field name and description:
    • Add the field name title and give it the value Garfield Park. Click Confirm.
    • Add the field name description and give it the value Home of the Garfield Park Conservatory. Click Confirm.

animated gif illustrating how to draw a new feature

Export the dataset as a tileset

Next, you will save and export the dataset as a tileset so that you can add it to a Mapbox style.

Create a tileset

  1. Click the Save button in the upper right corner of the editor to save your changes.
  2. Click the Export button, then select Export to a new tileset.
  3. Name your tileset chicago-parks and click Export. Screenshot illustrating how to export a dataset to a tileset in Mapbox Studio
  4. After your tileset has successfully uploaded, click the tileset’s name in the Notifications pane to open it.

Screenshot illustrating a successful tileset upload in Mapbox Studio

About tilesets

Web maps are made up of map tiles. A collection of tiles is called a tileset. Data must be cut up into tiles so it can be added to a web map and displayed at various zoom levels. To make Mapbox maps more performant, a dataset’s features are simplified when it is converted into a tileset.

Next steps

Next, start part 2 of this tutorial series to learn how to add your tileset to a map style in the Mapbox Studio style editor.