Dashboard

The Studio Dashboard page is your hub for accessing maps, data, and other assets.

Home

The Home tab appears upon logging in to Studio. This page provides quick access to your most recently created or updated maps, blog posts, and more.

Scroll down the home page to view:

Note: All assets you create in Studio are private until you publish or share them. If you want your map to be a candidate for the Maps We Love page, you need to publish and share it.

Documentation and Join Slack buttons

The Home page contains shortcuts to the Documentation hub and the Studio Community Slack channel. The Documentation hub is a place to learn the Studio platform in detail.

Projects

Projects allow for the organization of assets, such as maps and datasets, into project-focused buckets. Offering collaboration across your team, users can keep track of all project-related data in one place.

Create a New Project

To make a new project, follow these steps:

  1. Navigate to the Dashboard tab.

  2. Click + > Project to open the new project configuration.

  3. In the Add Project window, add a title for your project.

If you wish to share your project with an organization, select the organization in the Organization Access dropdown menu. Optionally, add an image, and a description.

When complete, click the Add button. You can edit a project you created at any time.

Add Folders

Folders can contain maps and data related to an aspect of your project. To add folders to projects, click + > Folder. In the Add Folder window you will be prompted for a name. Optionally, provide a description.

Add Assets to Projects

To add assets to projects, simply click + > Existing assets. You are brought to a panel containing maps and datasets. Toggle between the two by clicking the Maps and Datasets tab at the top. To add an asset to your project, either drag-and-drop the asset tile into the left hand sidebar, or click the checkbox on one or more asset tiles, then click + Add to, selecting the project (and optionally folder) you wish to add the asset to.

Share, Edit or Delete Projects

To share, edit, or delete a project, open the project context menu by hovering over your project in the left-hand sidebar. All three options will appear.

Note: Deleting a project will not delete any assets in the project.

Workspace

The Workspace is a central location for all saved assets in Foursquare Studio. Assets in the workspace tab include both your personal assets and assets shared with you.

Maps

The Maps tab contains a library of maps on your Studio account. To import a new map, click the Import Map next to the search button. Select any number of maps by clicking that checkbox on the top right of a map tile. When one map is selected, you can view its metadata in the information panel to the left. From the action bar, you can:

Organize and Filter Maps

You can sort maps with the Sort By dropdown menu and search for a map with the 🔍 Search box. To the right of the Sort By menu is the Filter button, allowing you to filter your maps with custom Tags.

Datasets

The Datasets tab contains a library of datasets on your Studio account. To import a new dataset, click Add New Dataset and select a local file of a supported format. Click on any number of datasets to select them. You can also click the open checkbox on the top of your datasets to select all datasets. From the action bar, you can:

Connectors

Data Connectors let you query and connect to popular databases and data providers, such as Athena, Bigquery, Redshift. Click Add New Data Connector then follow the instructions specific to your data provider.

Queries

SQL queries made from Studio are saved in the Queries section. Click a query's checkbox to select/deselect it. Selecting a query opens an action bar containing several buttons. From the action bar, you can:

Base Maps

The Base maps tab contains a list of all base maps saved to your Foursquare Studio account. To share base maps with your team, select any number of base maps then click the Share button.

Color Palettes

The Color Palettes tab shows all custom color palettes saved to your account. To share color maps with your team, select any number of palettes then click the Share button.

API Keys

Use API Keys tab to create an API Key or see all API Keys shared within an Organization to authenticate to Map SDK.