Data Lens Developer's Guide


This chapter gives you some background about Data Lens 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 the Data Lens cloud to the HERE Maps JavaScript API.

What do I need to start working with Data Lens?

To access Data Lens, you first need to sign up for a HERE Account on the following website:

Then, you need to sign up to a business plan to access Data Lens. You can request this on the following page, selecting "Data Lens" in the list:

The credentials you receive to work with Data Lens are a pair of personalized access codes, your app_id and app_code. These codes are associated with individual HERE products, and you need valid codes to access Data Lens.

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 design 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. However, in this example, you will use a sample dataset about recorded earthquakes that you access from the Data Lens cloud.

Note that 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.

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