Supported Geospatial Content in Data Lens

This article highlights the various geospatial formats that Data lens pages allow. 

Note: To utilize these features to their fullest potential, your dataset needs to include a geocoded location column.

Data lens allows users to display their geospatial data through Map Cards. In "Customize" Mode, add a card and select the location column from your dataset. Then you will be able to choose which map you'd like to use to visualize your data.

Map Card Types 

Choropleth Map

This feature allows a user to visually interact with the data in geospatial terms that are relevant to them such as school districts or neighborhoods. By default, Socrata has made zip codes, counties, states or countries available based on the type of customer’s organization.

Spatial Lens

To get the Choropleth Map option, you must already have Spatial Lens boundaries set up for your domain. Examples of Spatial Lens boundaries are neighborhoods and ZIP codes. For information on creating your spatial lens boundaries, follow this link.

Point Maps


Point maps distribute the individual data point rows on a map. This makes it easy for users to see the density of incidents or locations in the context of a map.  If dataset has more than 100,000 points, the point map will not display by default. You can add it as a card through the customize mode. 

When you hover over a point on the map, a flyout will appear telling viewers about that point. If there are multiple points on top of one another, you can click through the flyout for each point in that spot. Users are able to customize the flyout title.

Base Maps

For both Point Maps and Spatial Lens choropleths, the publisher has the option to modify the base map.

When in customize mode, select the Settings Gear in the top right corner of the card, this will present the settings menu.

In the settings menu you can select Simple Blue, Simple Grey, ESRI, or Custom Map. Custom Map enables you to populate the endpoint box with the web location of a base map available to you via an endpoint or web service. The format of your custom base map endpoint must be:{z}/{x}/{y}.png.



For datasets that include an location column, an endpoint for a GeoJSON API is available. This is accessible in the info pane at the top of a Data Lens page. By selecting API, the API menu will appear with links to corresponding documentation and Code Libraries. 



Was this article helpful?
1 out of 1 found this helpful
Have more questions? Submit a request



Article is closed for comments.