Geovisualization Developer's Guide


What is Geovisualization?

HERE Geovisualization 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 Geovisualization cloud, and transformed and aggregated to provide input to the JavaScript API, which renders the visualization on HERE maps.

The Geovisualization JavaScript API module connects the Geovisualization cloud to the HERE Maps JavaScript API.

What is this Tutorial About?

This tutorial will show you how to create a map visualization that fetches and process data using the Geovisualization REST API and its query language, and then uses the Geovisualization JavaScript API to plot data-driven markers on a map. In this example, you will upload a sample datasource to your account on the Geovisualization backend and use it in the project.

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. You will define a relative opacity on the marker symbols to indicate the relative epicenter depth.

The steps you will follow in this tutorial are:

  • Upload the earthquake data source in your Geovisualization account.
  • Create a query on the data using the Geovisualization REST API query language.
  • Publish the query to make it publicly available.
  • Design the proportional markers representing the data using the Geovisualization JavaScript API.

Get a HERE Account

To access Geovisualization, 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 Geovisualization.
Note: Geovisualization offers an extensive set of documented code examples of visualizations, showing all queries and source code. The full example described in this tutorial can be found at