Using Postman

Postman is a Chrome plugin and desktop application that helps you interact with APIs and see the output. We use it throughout our documentation to illustrate making requests. Other similar tools are available, but we recommend Postman so you can better follow our examples.

Installing Postman

To install Postman, download it from getpostman.com. Depending on which platform you decide to install, launching the application will be different, but the interface will be the same. To understand more about how to use Postman, we recommend you read their official documentation.

At the heart of Postman are collections, a group of individual requests and resources that form the API. Within a collection, resources can be organized into logical folders, and parameters such as authentication tokens received from one resource can be reused in others, making testing an API a more cohesive experience.

We have created two files to help you experiment with the Geovisualization REST API. An environment file that helps you set global variables for working with the Geovisualization REST API, and a collection of ready-made API requests with responses from some API calls included in the requests.

Import the Collection and Environment Files

To import, click the Import button on the top black bar of the application, click Choose Files under Import File and select the two files downloaded from above.

Set up Postman with your HERE Account Credentials

Postman lets you store credentials and variables so you do not need to keep entering them for every resource request. We recommend you add your account credentials, as well as the app_id and app_code sent to you after you registered for Geovisualization:

Select https://datalens.api.here.com as the active environment from the drop-down list next to the eye icon.

Click the eye icon and click Edit next to Globals at the bottom of the drop-down list.

In the Manage Environments box, select https://datalens.api.here.com in the list of environments.