Geo-visualization Developer's Guide

The Geo-visualization Workflow

The following list describes a typical workflow for creating visualizations with Geo-visualization. Follow the links to the detailed topics for more in-depth descriptions of each step.

  1. Prepare your data: The data you use in Geo-visualization must be in CSV format and follow some rules.

    See also: Data Format Guidelines

  2. Upload your data: You use the Geo-visualization REST API to upload your data to your account. First you create an empty dataset, and then you populate it by uploading your CSV files. You can subsequently append additional data to the dataset or delete it.

    See also: Managing your Data

  3. Define a query on the dataset: To consume data in your visualizations, you use the Geo-visualization REST API query language to define how to call and process your datasets. Queries are JSON objects that are run from within your app by calling its unique ID. (similar to 'prepared statements' in SQL.)

    You can define a query to be a simple construct to load data, or it can perform complex data transformations and other processing. In addition, you can define "dynamic parameters", which allow you to modify the parameters of the query using front-end URL parameters. This creates the interaction between the end-user viewing the visualization in the browser and the data processing being triggered in the background.

    You use the Geo-visualization REST API to save the query to your account and to publish it if you want to make the results of the query publicly available.

    See also: Querying your Datasets

  4. Fetch the query results: After you have defined a query, you call it in your app to be able to consume the data that results from the query. This query data is then provided to the JavaScript classes that will create the visualization.

    See also: Retrieving Data with a Query

  5. Create the visualization: Finally, you use the Geo-visualization JavaScript API and other JS libraries to consume your data and create a heat map, raster map, markers, and so on. You package this code with HTML, CSS and further JavaScript to create the finished app.

    See also: Creating Visualizations and Geo-visualization Code Examples

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