Geovisualization Developer's Guide


To retrieve data from your datasets, you need to define a 'query' with the Geovisualization REST API query language. In addition to simply fetching data, you can define a query to aggregate, transform, filter and sort the data before creating a visualization with it. Note that only dataset owners can create queries on a dataset.

A Geovisualization query is not a one-off action like a query in SQL. It corresponds more to the concept of 'prepared statements' in SQL, where you can create a query for later execution. This involves separating the sending of the query's source code and the actual data retrieval.

Query owners can choose to 'publish' a query to make it possible for non-authenticated users to use it. While a query remains private (unpublished), only the query owner can POST it to the Geovisualization REST API. This privacy option allows you to upload a sensitive dataset (for example, records with user information) but make a less sensitive query (for example, aggregating the number of users by country in the result). You can then make only the less sensitive data publicly available by publishing that query.

Fastpath: For examples of queries, we suggest you look at the Geovisualization code examples. These include all the code needed to create the visualizations, which you can copy and use as the basis for your own apps.

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