Data Lens Developer's Guide


This section covers what Data Lens is and what you need to know to get started with this Tutorial.

What is Data Lens?

HERE Data Lens is a cloud-based API toolkit for developing sophisticated visualizations of geographically-related data, accessible in a web browser. Raw data is queried via a REST API from the Data Lens cloud, and transformed and aggregated to provide input to the JavaScript API, which renders the visualization on HERE maps.

The Data Lens JavaScript API is a module that connects the Data Lens cloud to the HERE Maps JavaScript API.

What is this Tutorial About?

This tutorial will show you how to create a map visualization. It will fetch and process data using the Data Lens REST API and its query language, and then use the Data Lens JavaScript API to plot data-driven markers on a map. In normal usage, you would upload your own geographical data to your account on the Data Lens backend and use it in your projects. In this example, you will use a sample dataset about recorded earthquakes that you access from the Data Lens cloud.

Note: Data Lens provides a number of 'starter pack' datasets. In this tutorial, you will load these datasets to your account, and you can use them in your own visualizations to help you get to know Data Lens.

The example plots earthquake events on a map of the world. The events are represented on the map with symbols, called "proportional markers", whose size, color, and opacity vary according to the magnitude and depth of each earthquake. The marker's size indicates the magnitude of the earthquake, and its color indicates the depth of the earthquake epicenter. We also define a relative opacity on the marker symbols to indicate the relative epicenter depth.

The steps you will follow in this tutorial are the following:

  • Initialize the earthquake dataset in your Data Lens account.
  • Create a query on the data using the Data Lens REST API query language.
  • Publish the query to make it publicly available.
  • Design the proportional markers representing the data using the Data Lens JavaScript API.

Get a HERE Account

To access Data Lens, go to and sign up for a HERE account

Get a HERE Plan

When you have an account, register for a 90-day Free Trial plan on the HERE website:

Generate App ID and App Code

On the project page for the newly created plan, click the blue Generate App ID and App Code button under the JavaScript/REST heading to generate the App ID and App Code you will need for Data Lens.

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