Mapbox

This article describes the Mapbox component and all of its properties.

Who can use this feature?

All Squirrel365 plans include the Mapbox component.

For more details, see our pricing comparison matrix.

The Mapbox component is a visualization component that displays a dynamic and interactive map.

Select Mapbox from the Data Visualization category of the component library. Move the mouse over the canvas and click to add the Mapbox component to your project:

Mapbox Properties

The Mapbox properties consist of LAYOUT & POSITIONING, MAP SETTINGS, LOCATION DATA, and DYNAMIC VISIBILITY drawers. This guide will not describe the Layout & Positioning or Dynamic Visibility properties as these are generic to each visible component. Here you can find separate guides on Layout & Positioning and Dynamic Visibility

---

MAP SETTINGS

• Access token - an input field for the map access token. This can be acquired from your account on the Mapbox website.

For information on acquiring a Mapbox API token, see this article.

• Map style - a dropdown to select the style of the Map layers

  • Satellite Streets

  • Light

  • Dark

  • Streets

  • Outdoors

  • Navigation Day

  • Navigation Night

• Show zoom and pan controls - Checked by default, this option adds the zoom and pan controls to the map. Uncheck to hide these controls.

• Show terrain - Unchecked by default, use this option to add terrain to the map.

• Show 3D buildings - Checked by default, displays 3D buildings on the map.

• Allow cooperative gestures - Checked by default, use this option to enable or disable cooperative gestures. Read here to learn more about cooperative gestures.

MAP DEFAULTS

• Center map on...

  • Latitude - Input a location latitude (anywhere between -90 and 90). This property can be bound to the spreadsheet.

  • Longitude - Input a location longitude (anywhere between -180 and 180). This property can be bound to the spreadsheet.

  • Zoom level - an input to control the default map zoom level. This property can be bound to the spreadsheet.

  • Pitch - a slider to control the pitch and angle of the map view. The input value can be bound to the spreadsheet.

LOCATION DATA

• Marker Series - a series list to place markers on the map based on either an address, lat/long, or long/lat value in the spreadsheet.

Data in address format uses the MapBox Geocoding API

Examples of address data:

123 Squirrel Lane, Town, City Zip/Postcode

Swindon, UK

AZ 85658

• Name - Set the name of the series of location markers.

• Location Type - Choose the type of location data you have to plot on the map.

  • Address

  • Lat/Long

  • Long/Lat

• Locations - Bind to the range in the spreadsheet containing the location data.

  • Lat,long and Long,Lat data can be supplied as either 2 columns or a single column with a comma separating the values.

    
  • Address data should be supplied in a single column.

    
• Marker Color - Select the color for the markers by clicking the color swatch, to open the color picker, or entering a hex value. This property can be bound to the spreadsheet.

• Data Insertion - Configure data insertion to insert values when a marker is clicked. This is unchecked and disabled by default.

  • Data Insertion Type

    • Position

    • Series Name

    • Row

  • Source - Bind the source values for data insertion. This is only enabled for Row insertion types

  • Destination - Bind the destination cell(s) for the data.