Data Lens Developer's Guide

What is Data Lens?

Data Lens is an API toolkit for creating data-driven visualizations on a map. You create web apps using data that you fetch using the Data Lens REST API and that you style using the Data Lens JavaScript API. This topic describes the components of Data Lens that you use to create your own apps.

Fastpath: We recommend that you study the Data Lens code examples. These demonstrate the different technologies that Data Lens provides and include some real-world use cases. The examples include all the code needed to create the visualizations, which you can copy and use as the basis for your own apps.

First prepare your data ...

Data Lens consumes geographically-related data and prepares it for visualization apps. You first need to upload your raw data to your Data Lens account with the Data Lens REST API. This creates structured datasets that Data Lens can consume. Using the specialized Data Lens REST API query language, you then define 'queries' (JSON objects) on your datasets. A query can transform the data, such as by aggregation, filtering or sorting. In your visualization JavaScript code, you invoke a service that calls a query, and the Data Lens REST API returns the resulting data to your app.

... then create your visualization ...

Once the data is prepared and your query is called into your app, you employ the Data Lens JavaScript API to create the visualization. You do this by defining layers on the base map. For example, you can create a heat map or raster map and then include data-driven markers on the same map. The layers can reflect data ranges and react to viewport zoom levels, and can also be interactive (for example, showing a popup on clicking a marker). Additionally, you can call third-party JavaScript libraries (for example, d3.js) to visualize your data in other ways, such as with bar charts or pie charts.

... or you can copy one of ours

The following is an example of a heat map, where the 'bandwidth' (a parameter that controls the distribution of density) can be explicitly controlled in the viewport. You can view and copy the full code for this example, and many others, on the HERE API Explorer.

Figure 1. Example: Heat Map showing Density Distribution, with Bandwidth Slider (click the image to go to the code example)

You cannot use this account to purchase a commercial plan on Developer Portal, as it is already associated to plans with different payment methods.

To purchase a commercial plan on Developer Portal, please register for or sign in with a different HERE Account.

Something took longer than expected.

The project should be available soon under your projects page.

Sorry, our services are not available in this region.

Something seems to have gone wrong. Please try again later.

We've detected that your account is set to Australian Dollars (AUD).
Unfortunately, we do not offer checkouts in AUD anymore.
You can continue using your current plan as normal, but to subscribe to one of our new plans,
please register for a new HERE account or contact us for billing questions on